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戏子 版 权 巨 明 


图 灵 社 区 的 电子 书 没 有 采用 专 有 客户 
端 ， 您 可 以 在 任意 设备 上 ， 用 目 己 襄 
欢 的 浏览 器 和 PDF 阅读 器 进行 阅读 。 
但 您 购买 的 电子 书 仅 供 您 个 人 使 用 ， 
未 经 授权 ， 不 得 进行 传播 。 

我 们 愿意 相信 读者 具有 这 样 的 民 知 和 
帝 悟 ， 与 我 们 共同 保护 知识 产权 。 
如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 对 
该 用 户 买 施 包括 但 不 限于 关闭 该 帐号 
等 维权 措施 ， 并 可 能 奶 究 法 律 责任 。 


池田 尚 史 

DeNA 软 件 开 发 工程 师 。 曾 做 过 IT 顾问 、 程 
序 员 ， 从 事 过 软件 包 开 发 、Web 服 务 开发 。 
Java 的 Web 应 用 框架 Play Framework 1 的 提 
交 者 。 负 责 本 书 第 1 章 ~ 第 5 草 ， 其 中 第 2 章 的 
案例 分 析 都 是 基于 自身 的 实际 经 验 编写 的 。 
Twitter @ikeike443 


蕨 仓 和 明 

想 能 ( SHANON ) 基础 设施 工程 师 。 负 责 公 
司 内 部 基础 设施 及 服务 环境 的 安全 保障 ， 致 
力 于 推动 应 用 部 署 的 自动 化 ， 并 基于 这 方面 
丰富 的 实践 经 验 ， 完 成 了 本 书 第 6 章 。 喜 欢 
OpenVZ、LXC 等 容器 型 虚拟 化 技术 。 
Twitter @fujya 


井上 史 彰 

想 能 ( SHANON ) 软件 工程 师 、OA 工 程 师 ， 
现 为 想 能 信息 科技 ( 上海 ) 有 限 公 司 总 经 理 。 
开发 经 验 丰 富 ， 致 力 于 推动 高 效 的 自动 化 测 
试 。 负责 本 书 第 7 章 。 

E-mail fu.Inoue@gmall.com 


严 圣 饮 
毕业 于 上 海 交通 大 学 。8 年 软件 开发 经 验 ， 
期 间 赴 日 本 工作 。 现 就 职 于 想 能 信息 科技 
( 上海 ) 有 限 公司 ， 从 事 基于 云 平台 的 客户 
关系 管理 及 各 类 营销 自动 化 系统 的 开发 ， 便 
重 于 对 持续 集成 、 自 动 化 部 署 、 自 动 化 测试 
以 及 相关 的 开源 工具 的 研究 。 本 书 所 介绍 的 
即 是 译 者 日 常 工作 中 所 应 用 的 开发 流程 以 及 
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内 容 提 要 
本 书 以 团队 开发 中 所 必需 的 工具 的 导入 方法 和 使 用 方法 为 核心 , 对 团队 开 有 的 
整体 结构 进行 概括 性 的 说 明 。 内 容 涉 及 团队 开发 中 及 生 的 问题 、 版 本 管理 系统 、 缺陷 
管理 系统 、 持 续集 成 、 持续 交付 以 及 回归 测试 , 并 且 对 “为 什么 用 那个 工具 ”为 什么 
要 这 样 使 用 ”等 开 友 现场 党 有 的 问题 进行 举例 说 明 。 
本 书 适 合 所 有 想 要 系统 性 地 学 习 团 队 开 及 工具 的 人 了 阅读。 
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致 中 文 版 的 读者 


感谢 您 购买 了 《高 效 团 队 开 发 : 工具 与 方法 六 同样 要 感谢 已 经 决 
定购 买 本 书 的 读者。 还 在 犹豫 是 否 购 灭 本 书 的 读者 ， 如 打 您 看 了 这 篇 序 
后 决定 购买 ， 那 将 没有 比 这 更 令 人 融 兴 的 事情 了 。 

本 书 是 由 我 、 想 能 (SHANON ) 时 期 的 同事 藤 仓 和 明 先 生 与 井上 史 
彩 先 生 共 同 写作 的 。 这 次 是 受到 想 能 上 海 分 公司 总 经 理 井 上 先生 的 委托 
来 写 的 这 篇 序 。 

其 实 我 并 没有 去 过 中 国 大 陆 。 因 此 ， 从 真正 意义 上 来 次 ， 我 并 不 知 
道中 国 软件 行业 的 真实 情况 。 当 然 ， 像 阿里 巴巴 和 腾讯 这 样 的 大 公司 还 
是 知道 的 ， 但 我 没有 在 中 国 工 作 的 经 历 。 

中 国 的 软件 工程 师 极 为 优秀 。 我 所 在 的 公司 就 有 很 多 非常 优秀 的 
中 国 工程 师 。OSS 社区 也 经 党 能 看 到 中 国 的 工程 是， 他 们 部 十 分 令 人 
僻 佩 。 

中 国 工程 师 无 疑 是 非常 出 众 的 ， 但 中 国 的 软件 开发 环境 是 怎样 的 
呢 ? 缺陷 管理 和 分 布 式 厂 本 管理 的 运用 ， 测 试 代 码 的 履 关 和 CI 的 配备 ， 
部 警 的 目 动 化 等 机 制 的 组 合 应 用 ， 这 些 我 听 说 都 还 刚刚 起 步 。 

您 所 在 的 开发 现场 又 是 怎样 的 呢 ? 

如 东 上 述 情形 并 未 出 现在 您 的 开发 现场 中 ， 那 么 非常 抱歉 ， 人 和 您 不 需 
要 这 本 书 。 请 将 这 本 书 放 回 书架 ， 回 去 继续 工作 。 如 果 存 在 上 述 情 形 ， 
那么 本 书 将 对 您 有 所 带 助 。 

在 日 本 ， 能 够 构建 本 书 中 所 写 的 高 效 开 发 环境 的 公司 和 无 法 构建 这 
样 的 环境 的 公司 之 间 有 着 很 大 的 差距 。 究 其 原因 ， 其 一 是 完备 的 环境 有 
助 于 提高 开发 效率 ， 能 够 迅速 地 发 布 优秀 的 产品 或 服务 ; 其 二 是 因为 工 
程 师 注重 团队 开发 环境 是 否 完 善 ， 开 发 环境 完善 的 公司 能 够 吸引 到 优秀 
的 工程 师 ， 而 优秀 的 工程 师 越 多 开发 效率 目 然 束 越 高 。 这 样 一 来 ， 公 司 
之 间 的 差距 就 越 来 越 大 ， 这 就 是 日 本 的 真实 情况 。 

同样 的 情况 在 中 国 也 会 发 生 ， 或 许可 能 后 就 已 经 在 发 生 了 。 

团队 开发 环境 的 完善 就 像 “减肥 ”一 样 。 明 明知 道 只 要 去 做 就 会 有 
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效果 、 有 益处 ,但 却 信 述 没有 付 之 于 行动 。 往 往 会 以 太 忙 了 、 有 其 他 优 
完 度 更 高 的 工作 为 由 来 应 付 过 去 。 

本 书 第 2 草 讲述 了 如 有 果 俘 慢 这 个 “减肥 ”会 变 成 什么 情形 。 那 是 我 
过 去 的 真实 体验 ， 为 了 避免 重复 那样 的 经 历 ， 只 要 是 能 够 提高 团队 开 
发 效率 的 事情 ， 我 都 会 去 尝试、 实践 ， 而 本 书 就 是 这 些 和 尝试 和 实践 的 
结 品 。 

请 大 家 务必 阅读 、 学 习 本 书 ， 避 人 免 陷 入 第 2 草 中 摘 述 的 悲惨 境地 。 
已 经 陷入 上 述 境地 的 各 位 ， 更 应 该 阅读 本 书 ， 以 便 能 够 从 上 述 境地 中 解 
脱出 来 。 

上 文 已 经 提 到 ， 在 日 本 是 否 能 够 实践 本 书 的 内 容 ， 决 定 了 公司 则 的 
差距 。 各 位 读者 也 请 学 习 、 实 践 本 书 的 内 容 ， 以 使 自己 所 在 的 公司 能 和 
苑 争 对 手打 开 差 距 。 

如 果 您 的 实践 一 切 顺利 的 话 ， 请 告知 我 一 下 ， 我 们 可 以 一 起 去 哆 一 
杯 。 只 要 有 您 的 邀请 ， 我 随时 都 可 以 去 中 国 ! 我 非常 喜欢 绍兴 酒 ， 日 酒 
也 想 党 试 一 下 二) 
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《 融 效 团队 开发 : 工具 与 方法 》 并 不 是 以 实际 的 项 目 带 你 体验 多 人 
开发 项 目的 整体 流程 ， 而 是 告诉 你 使 用 哪些 工具 和 方法 能 够 实现 高 效 的 
团队 开发 。 从 版 本 管理 系统 、 缺 陷 管 理 系统 到 CI 工具、 虚拟 化 、 目 动 
化 测试 等 ， 无 论 你 使 用 哪 种 语言 、 框 如 、 软 件 开 发 模式 ， 无 论 你 是 负责 
开发 、 测 试 ， 还 是 负责 运 维 、 项 目 管 理 ， 都 会 涉及 这 些 工 具 。 这 些 工 具 
也 下 接 影响 者 开发 和 运 维 的 效率 、 项 目 成 本 以 及 公司 的 日 浓 开 销 。 

随 看 SaaS( 软件 即 服 务 ) 的 普及 ， 越 来 越 多 的 项 目 已 经 不 是 经 过 一 
段 时 间 的 密集 开发 就 结束 的 了 。 后 期 的 开发 ， 包 括 集成 、 测 试 、 运 维 
(部 署 、 发 布 等 )， 从 重要 性 以 及 成 本 的 角度 来 看 都 已 经 成 为 项 目 中 的 重 
要 部 分 。 本 书后 半 部 分 介绍 的 持续 集成 、 目 动 部 署 (持续 交付 ) 以 及 回 
归 测 试 ， 都 能 有 效 地 帮助 这 样 的 项 目 提高 质量 、 加 快 开发 速度 、 降 低 运 
维 成 本 。 

本 书 让 我 印象 较 次 的 一 点 是 贯穿 全 书 的 目 动 化 意识 ， 包 括 目 动 化 环 
境 构 建 、 持 续集 成 、 自 动 化 测试 、 上 自动 部 署 和 发 布 。 点 击 女 标 提交 代码 
和 测 斌 用例， 借助 CI 和 各 类 自动 化 工具 ， 目 动 触发 编 泽 、 集 成 、 测 试 、 
部 署 ， 还 会 目 动 将 版 本 管理 系统 中 提交 的 信息 关联 到 缺陷 管理 和 CI 系 
统 中 ， 几 分 钟 后 打开 浏览 帝 台 能 够 “ 吾 受 ” 目 己 的 萎 动 成 有 末了。 这 样 的 
场景 实在 太美 了 。 想 来 是 因为 日 本 长 期 的 秀 动 力 不 足 以 及 高 昂 的 荔 动 力 
成 本 才 让 作者 对 于 自动 化 如 此 执着 。 对 于 还 能 够 享受 人 口红 利 的 中 国 软 
件 行业 来 说 ， 目 动 化 也 是 非常 必要 的 。 除 了 能 够 在 开发 、 测 试 、 运 维 等 
多 方面 降低 成 本 之 外 ， 上 自动 化 环境 构建 、 目 动 化 测试 这 样 的 机 制 能 够 降 
低 项 目 对 于 成 员 个 体 的 依赖 ， 在 大 规模 的 团队 开发 中 以 及 在 灵活 调整 团 
队 规 模 方面 都 是 必 不 可 少 的 。 

本 书 所 介绍 的 内 容 对 于 公司 来 说 不 仅 可 以 提高 效率 ， 降 低 成 本 ， 还 
可 以 成 为 公司 的 一 张 名 片 。 持 续集 成 、 目 动 化 测试 、 持 续 交 付 ， 加 上 
Github 、Jenkins 、Vagrant、Chef、serverspec 、Selenium 这 些 工 具 ， 由 此 
构筑 起 的 技术 堆栈 ， 无 论 是 对 于 开发 、 测 试 人 员 还 是 运 维 人 员 来 说 都 是 
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非常 具有 吸引 力 的 。 对 于 个 人 来 说 ， 除 了 扩展 上 自己 的 知识 之 外 ， 还 能 作 
为 你 选择 公司 的 重要 参考 依据 ， 判 断 公 司 是 否 对 技术 敏感 ， 推 测 项 目 大 
致 的 工作 流程 以 及 是 否 可 能 成 为 Death march。 更 重要 的 是 

员工 : “老板 ， 我 要 加 工资 1” 

老板 :“ 为 什么 ?” 

员工 :“ 因 为 我 长 得 是 1” 














员工 :“ 因 为 我 跟 你 10 年 了 ， 没 有 功 务 也 有 二 天 吧 ! 

老板 :“ 好 吧 ， 加 5% 差不多 了 。” 

员工 :“ 这 个 项 目 交 给 我 ， 我 有 办 法 只 需要 一 半 的 人 手 就 能 完成 ! 

老板 :“ 真 的 ?好 ! 工资 翻 售 !” 

最 后 感谢 在 翻译 过 程 中 给 予 我 文 持 及 或 励 的 各 位 。 特 别 是 我 的 妻 
子 ， 翻 详 这 段 时 间 恰 好 是 她 怀孕 和 生产 的 时 候 。 我 们 平安 地 迎 来 了 家 里 








的 新 成 员 深 深 ， 借 此 祝愿 他 健康 成 长 。 
一 
2015 年 3 月 于 上 海 
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本 书 名 为 《高 效 团队 开发 : 工具 与 方法 》。 

读者 朋友 们 大 多 都 知道 ， 团 队 开 发 是 一 件 复杂 、 困 难 的 事情 。 

关于 团队 开发 ， 现 在 已 经 有 了 各 式 各 样 的 方法 论 和 工具 。 方 法 论 方 
面 ， 除了 Scrum、XP 等 敏捷 开发 以 外 ， 还 有 些 更 具体 的 设计 开发 方法 ， 
如 TDD (Test Driven Development， 测 试 驱 动 开 发 )、BDD ( Behavior 
Driven Development,， 行为 驱动 开发 )、TiDD ( Ticket Driven Development， 
缺陷 驱动 开发 ) 等 ， 以 及 具体 实践 ， 如 CI ( Continuous Integration， 持 
续集 成 )、CD ( Continuous Delivery， 持续 交付 ) 等 。 讲 述 这 些 方法 论 的 
书籍 、 杂 志 以 及 网 站 到 处 都 是 ， 甚 至 多 得 让 人 不 知 该 从 何 处 着 手 。 

再 看 一 下 从 技术 上 文 持 这 些 方法 论 的 工具 ， 和 缺陷 管理 系统 、 版 本 管 
理 系统 、 目 动 化 测试 、 静 态 分 析 工 具 、 目 动 化 部 署 工具 等 ， 仅 是 种 类 就 
有 很 多 。 即 使 是 简单 地 列举 每 一 类 中 具有 代表 性 的 工具 ， 其 数量 就 多 得 
令 人 感到 头 军 。 

并 且 和 数 年 前 相 比 ， 文 持 团 队 开 发 的 工具 已 经 变 得 非常 吻 用 ， 能 方 
便 地 构建 高 效 的 开发 流程 。 但 由 于 信息 量 过 多 ， 并 且 很 分 散 ， 所 以 想 要 
系统 性 地 学 习 或 者 对 新 人 进行 高 效 的 培训 都 还 是 比较 困难 的 。 正 是 因为 
意识 到 了 上 述 这 些 问题 ， 笔 者 才 有 了 写作 本 书 的 想法 。 

本 书 以 团队 开发 中 所 必需 的 工具 的 导入 方法 和 使 用 方法 为 重点 ， 对 
团队 开发 的 整体 结构 进行 概括 性 的 说 明 。 并 且 对 “为 什么 用 那个 工 
具 ” “为 什么 要 这 样 使 用 ”等 开发 现场 党 有 的 一 些 问 题 进行 举例 说 明 。 

布 望 你 能 吾 欢 本 书 。 


读者 对 象 
本 书 适合 的 读者 对 象 有 : 



























































@ 初次 接手 开发 团队 的 项 目 经 理 
@ 计划 开始 新 项 目的 项 目 经 理 、Scrum Master 
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e@ 现 有 项 目 中 返工 、 延 期 问题 频 发 ， 想 了 解 能 帮助 自己 解决 这 些 问 
题 的 工具 及 其 使 用 方法 的 人 

e@ 测试 是 测试 部 门 的 事 ， 与 己 无 关 ; 部 署 、 发 布 是 运 维 部 门 的 事 ， 
与 己 无 关 一 一 有 如 此 想法 的 人 

e@ 想 了 解 最 近 能 够 在 Web 服务 开发 中 发 挥 作 用 的 工具 的 人 
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1.1 一 个 人 也 能 进行 开发 


想必 大 家 都 知道 ， 一 个 人 也 可 以 进行 软件 开发 。 自 由 软件 以 及 共享 
软件 的 开发 人 员 大 多 都 是 个 人 开发 者 。 这 几 年 来 ， 以 个 人 形式 开发 
iPhone 应 用 或 Android 应 用 并 一 炮 而 红 的 开发 者 也 不 在 少数 。 网 上 也 有 
一 些 个 人 开发 的 作为 OSS( Open Source Software ) 的 实用 小 工具 。 

笔者 从 自己 的 兴趣 出 发 ,偶尔 也 会 写 一 些 Jenkins” 和 Sublime Text 
插件 与 大 家 共 诗 。 一 个 人 进行 软件 开发 的 情况 下 ， 因 为 没有 沟通 成 本 ， 
所 以 能 够 迅速 地 开发 并 发 布 。 在 软件 规模 ” 较 小 的 前 提 下 ， 全 部 流程 由 
一 个 人 把 控 还 是 可 能 的 。 

但 是 如 有 果 软 件 的 规模 超过 一 定 程 度 ， 仅 由 一 个 人 把 探 产品 的 所 有 内 
容 就 比较 困难 了 。 不 难 想 象 ， 这 时 候 就 需要 由 多 人 组 成 团队 进行 开发 。 

而 且 人 们 对 于 软件 产品 的 要 求 越 来 越 高 ， 因 此 软件 开发 ， 特 别 是 在 
企业 内 部 的 开发 现场 ， 由 多 人 组 成 团队 进行 开发 是 非常 普遍 的 。 

本 书 将 由 多 人 开发 程序 的 体制 称 为 团队 开发 。 

















(D http://jenkins-ci.org/ 
@ http://www.sublimetext.com/ 
GB) 衡量 软件 规模 的 指标 有 很 多 种 ， 例 如 用 户 数 、 功 能 数 、 代 码 行 数 等 。 
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1.2 团队 开发 面临 的 问题 


随 着 开发 的 进行 ， 团 队 会 遇 到 各 式 各 样 的 问题 : 团队 内 部 对 遇 到 的 
问题 没有 共享 、 项 目 进度 无 法 掌控 、 多 人 编写 同一 个 产品 的 代码 造成 开 
发 内 容 冲 突 等 。 而 且 由 于 涉及 多 个 人 ， 所 以 代码 质量 的 统一 以 及 产品 代 
码 的 整体 把 控 都 变 得 越发 困难 。 

如 今 的 软件 开发 已 经 不 是 一 旦 发 布 (release ) 就 意味 着 开发 结束 这 
样 的 模式 了 。 很 多 情况 下 都 需要 在 运营 的 过 程 中 不 断 地 更 新 。 因 此 ， 在 
这 样 一 段 较 长 的 时 间 中 ， 有 必要 将 一 个 人 难以 完成 的 代码 交 由 多 个 人 并 
行 修改 , 并 且 要 在 一 定 程度 上 保证 代码 品质 ,防止 退化 ( degrade )”, 同 
时 还 要 不 断 地 增加 新 的 功能 。 

人 是 会 犯错 并 且 容 易 遗 忘 的 生物 。 微 小 的 失误 就 可 能 造成 系统 的 退 
化 ,并且 对 复杂 的 软件 进行 全 方位 、 毫 无 遗漏 的 测试 也 是 不 可 能 的 ， 而 
由 多 个 人 进行 开发 还 有 可 能 出 现 内 容 上 相互 矛盾 的 代码 。 即 使 是 自己 1 
个 月 前 写 的 代码 ， 也 有 可 能 完全 忘记 ， 甚 至 错 认为 是 别人 写 的 代码 。 



































添加 新 功能 或 修正 bug 造成 之 前 正常 运行 的 其 他 功能 无 法 运行 或 者 运行 速度 变 慢 
的 现象 。 
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1.3 如何 解 决 这 些 问 题 





要 解决 团队 开发 所 面临 的 问题 ， 仅 仅 乱 努力 是 行 不 通 的 。 全 世界 的 
工程 师 们 为 了 解决 类 似 的 问题 而 开发 了 各 类 工具 和 方法 论 ， 除 了 对 其 加 
以 有 效 利用 之 外 别 无 他 法 。 

在 多 个 人 之 间 共 至 问题 ， 将 所 发 生 的 事情 以 简明 易 异 的 方式 公开 ， 
以 及 为 了 防止 退化 发 生 ， 执 行 日 动 化 测试 ， 这 些 者 是 非常 午 要 的 。 除 此 
以 外 ， 一 旦 发 生 错误 ， 能 够 立即 回 滚 到 之 前 的 状态 也 极其 关键。 万 一 方 
面 ， 如 琳 不 能 迅速 地 开发 新 功能 并 发 布 ， 就 会 在 激烈 的 市 场 苑 争 中 败 下 
阵 来 ， 所 以 还 必须 并 行 地 开发 多 个 功能 。 当 然 这 些 乔 是 以 保证 质量 为 前 
提 的 。 

综 上 了 可见， 团队 开发 绝 非 吻 事 。 为 了 团队 开发 能 够 顺利 地 推进 ， 以 
下 几 点 是 必 不 可 少 的 。 

















e“ 谁 ”“ 到 何 时 为 止 ” 做 了 “什么 事情 "、“ 怎 样 ” 才 算 “ 完 成 ” 
等 ， 必 须 对 这 样 的 信息 进行 管理 和 共享 

e 代码 等 各 类 工作 成 果 ， 必 须 在 团队 内 部 共享 

e 管理 工作 成 果 的 变更 ， 既 要 防止 成 果 被 破坏 ， 又 要 保证 各 成 员 能 
够 利用 成 果 并 行 地 作业 

e 在 团队 中 共享 从 项 目 中 学 到 的 知识 

e 证 明 团 队 开发 出 的 软件 在 任何 时 候 都 是 可 以 正常 运行 的 

e 构建 任何 人 都 可 以 正确 开发 、 测 试 、 发 布 的 自动 化 工作 流程 
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1.4 本 书 的 构成 











为 了 解决 上 述 诛 题 ， 本 书 将 对 各 类 工具 及 其 使 用 方法 进行 讲解 。 


1.4.1 第 2 章 :案例 分 析 

在 讲解 的 顺序 上 ， 首 先 为 了 了 解 诸 事 不 顺 、 无 法 顺利 进行 的 项 目 究 
竟 是 怎样 的 ， 我 们 将 在 第 2 章 模拟 在 参与 某 个 项 目的 两 天 时 间 内 所 发 生 
的 事情 ; 然后 介绍 如 何 解 决 在 这 两 天 时 间 中 出 现 的 问题 ， 并 从 之 后 的 第 
3 章 开 始 对 相应 的 工具 进行 讲解 。 











1.4.2 第 3~5 章 :基础 实践 


seeeeeeeeeeseeeseeeseseeeeeeeseeeeseeseeseeseseeeeseeseseeeeseeeseeeeseeeeeeseeseeeeeeeseeeeeee 








从 第 3 章 开 始 ， 将 依次 介绍 改善 团队 开发 中 需要 进行 的 工作 。 各 位 
读者 可 以 按 顺 序 阅 读 ， 并 逐个 实行 。 

第 3 章 是 关于 版 本 管理 系统 ( Version Control System，VCS ) 的 
内 容 。 想 必 大 多 数 人 已 经 在 使 用 版 本 管理 系统 了 。 本 章 将 在 回顾 版 本 
管理 系统 飞速 发 展 的 历史 的 同时 ， 以 git-flow 和 GitHub-flow 这 两 个 具 
有 代表 性 的 工作 流程 为 例 ， 对 当下 最 流行 的 分 布 式 版 本 管理 系统 的 使 
用 方法 进行 讲解 。 后 面 在 内 容 上 还 更 进一步 ， 讲 解数 据 库 模式 变更 管 
理 的 重要 性 。 

第 4 草 是 关于 缺陷 管理 系统 ( Issue Tracking System/Bug Tracking 
System，ITS/BTS ) 的 内 容 。 这 里 的 缺陷 管理 是 指 将 完成 项 目 所 必需 的 
任务 (task ) 以 bug 票 的 形式 进行 管理 。 包 括 商 用 软件 在 内 ， 缺 陷 管 理 
工具 的 数量 很 多 ， 让 人 不 知 该 如 何 挑选 ， 因 此 这 里 将 介绍 一 些 挑 选 时 的 
要 点 。 这 一 董 还 探讨 了 结合 使 用 缺陷 管理 和 版 本 管理 系统 所 带 来 的 优 
势 ， 以 及 使 用 缺陷 管理 系统 时 读 题 的 颗粒 度 问 题 。 
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第 5 草 是 关于 持续 集成 ( Continuous Integration，CI ) 的 内 容 。 佑 计 
很 多 开发 现场 都 已 经 使 用 了 版 本 管理 系统 和 缺陷 管理 系统 ， 但 还 没有 使 
用 CI。 进 入 测试 阶段 后 ， 首 次 下 载 所 有 修改 的 代码 并 试看 编译 时 ， 发 现 
编译 错误 ,或 者 程序 无 法 启动 ， 有 如 此 经 历 的 读者 想必 不 在 少数 吧 。 

为 了 避免 上 述 问 题 ， 就 需要 导入 CI。CI 会 持续 地 下 载 代码 的 变更 
或 者 依赖 天 系 的 变更 等 所 有 变更 内 容 并 进行 编译 。 导 入 CI 可 以 同时 提 
高 开发 速度 及 质量 。 这 章 将 讲解 实施 CI 所 必要 的 编译 工具 、 测 试 框架 
以 及 CI 工具 。 

到 第 5 章 为 止 ， 都 是 在 讲述 为 了 顺利 推进 团队 开发 所 需 的 基础 实 
践 。 请 认真 阅读 前 5 音 ， 并 试 着 实际 操作 一 下 。 在 前 $ 章 的 内 容 已 经 全 
部 实现 的 开发 现场 ， 如 有 果 要 进一步 推进 团队 开发 ， 束 需要 用 到 从 第 6 章 
开始 介绍 的 内 容 。 























1.4.3 第 6~7 章 :持续 交付 和 回归 测试 


seeeeeeeseeeeseeseseeeeeeseeeeseeeseeeseeeeseeeeeee 








第 6 草 是 关于 持续 交付 ( Continuous Delivery，CD ) 的 内 容 。 这 里 
将 对 能 够 进行 目 动 化 环境 构建 ， 并 结合 CI 实践 在 任意 时 间 、 重 复 地 将 
运行 的 程序 发 布 到 正式 环境 中 的 机 制 进行 讲解 。 

第 7 草 是 关于 回归 测试 的 内 容 。 反 复 从 用 户 角 度 运行 用 户 验 收 测 
试 ， 以 此 来 确保 没有 退化 发 生 ， 这 是 实现 快速 产品 发 布 中 必 不 可 少 的 环 
节 。 本 章 将 讲解 使 用 Selenium 和 Jenkins 来 实现 回归 测试 的 自动 化 ， 还 
将 进一步 介绍 为 了 加 快 测试 速度 所 需要 的 分 布 式 测试 环境 的 搭建 。 
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1.5 阅读 本 书 前 的 注意 事项 


选择 团队 开发 中 所 使 用 的 工具 和 方法 论 ， 并 没有 唯一 且 绝 对 正确 的 
答案 。 根 据 企 业 规 模 、 产 品 规模 、 团 队 规模 的 不 同 ， 最 合适 的 工具 和 方 
法 论 也 不 尽 相 同 。 而 且 ， 团 队 开发 的 工具 、 方 法 论 的 选择 范围 也 非 篆 
大 ,但 这 并 不 意味 春 全 都 要 使 用 。 











1.5.1 最 好 的 方法 是 具体 问题 具体 分 析 


在 团队 开发 的 世界 中 ， 没 有 到 哪 都 适用 的 万 能 的 最 佳 实 践 ， 只 有 根 
据 实 际 情况 制定 的 方案 才能 行 得 通 ， 这 样 的 思考 方法 才 是 比较 正确 的 。 
是 否 能 找到 最 适合 目 己 所 从 事项 目的 解决 方案 ， 可 以 说 是 能 否 将 项 目 导 
癌 成 功 的 关键 所 在 。 

例如 ， 在 实际 的 项 目 中 ， 有 需要 将 缺陷 管理 系统 、 版 本 管理 系统 、 
CI、CD 这 些 方法 全 部 使 用 的 ， 也 有 只 需要 版 本 管理 和 CI 就 足够 的 。 














1.5.2 ”没有 最 好 的 工具 


在 工具 的 选择 方面 也 没有 正确 的 符 采 。 仪 以 缺陷 管理 系统 来 说 ， 是 
使 用 Redmine 好 ,还 是 使 用 JIRA” 好 呢 ? 或 者 是 只 使 用 GitHub” 就 足够 
了 呢 ? 答案 会 因 具 体 的 情况 不 同 而 发 生变 化 。 

CI 的 情况 也 一 样 ， 是 使 用 Jenkins 好 还 是 使 用 Travis 0 好 , 或 者 是 
使 用 其 他 的 工具 比较 好 ， 不 能 一 概 而 论 。 至 于 CD， 如 今 也 有 各 类 工具 
相继 推出 ， 哪 个 是 最 好 的 还 很 难说 。 

















http:/www.redmine.org/ 
https://www.atlassian.com/ja/software/jira 
https://github.com/ 

https://travis-ci.org/ 


©OOOO 
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想 要 在 本 书 中 一 一 介绍 各 类 方法 和 工具 的 所 有 组 合 模式 是 不 可 能 
的 ， 所 以 本 书 将 主要 讲解 本 书写 作 时 (2014 年 3 月 ) 的 一 些 优秀 的 模 
式 。 如 果 有 多 个 选项 的 话 ， 也 将 尽量 向 读者 们 展示 。 

在 接 下 来 的 第 2 章 中 ， 我 们 将 围绕 诸 事 不 顺 、 无 法 顺利 推进 的 项 目 
案例 展开 ， 一 起 思考 该 如 何 改善 这 种 情况 。 








图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


第 力 章 


团队 开 发 中 友 生 的 问题 


2.1 委 例 分 析 的 前 提 10 
2.2 ”案例 分 析 (第 1 天 ) 11 


2.3 案例 分 析 (第 1 天 ) 中 的 问题 点 16 
2.4 案例 分 析 (第 2 天 ) 22 
2.5 案例 分 析 (第 2 天 ) 中 的 问题 点 30 


2.6 什么 是 理想 的 项 目 37 
2.7 ”本章 总 结 40 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


10 | 第 2 章 团队 开发 中 发 生 的 问题 


2.1 案例 分 析 的 前 提 





用 于 高 效 推进 团队 开发 的 各 类 工具 和 方法 数量 众多 。 工 具 的 话 有 版 
本 管理 系统 (Version Control System，VCS ) 和 和 缺陷 管理 系统 ( Issue 
Tracking System 、Busg Tracking System，ITS/BTS )。 方 法 的 话 有 持续 
集成 ( Continuous Integration，CI) 以 及 最 近 比 较 热门 的 持续 交付 
(Continuous Delivery, CD )。 

为 什么 需要 这 些 工 具 和 方法 ?为 了 回答 这 个 问题 ， 我 们 先 要 知道 如 
果 不 使 用 这 些 工 具 和 方法 论 ， 项 目 会 怎么 样 。 

本 章 将 对 陷入 死亡 行军 ”状态 项 目的 两 天 时 间 进 行 案例 分 析 ， 看 一 
下 类 似 这 样 的 项 目 中 容易 出 现 的 现象 ， 随 后 反思 其 中 存在 的 问题 。 并 以 
此 为 基础 ， 从 第 3 章 开 始 讲 解 具 体 的 应 对 方法 。 

















2.1.1 项 目的 前 提 条 件 


本 草 所 涉及 的 项 目的 前 提 条 件 如 下 。 


seeeeeseeeeeeeseeseeeeeeeseeeseeseeeseesseeeeseeseseeseeseeeseesseeeseeseeeesseeseeeeseeeseeseseeeseeeseeeeeeeeee 


e 系统 由 网 站 + 数据 库 构 成 
e 不 仅仅 要 进行 开发 ， 发 布 后 还 需要 持续 地 进行 版 本 更 新 和 运 维 等 








各 位 可 以 想象 一 下 目 己 吴 处 目 行 开发 并 负责 运 维 互联 网 服务 的 企 
业 ， 或 者 负责 开发 企业 内 部 业务 系统 的 软件 部 门 时 的 情形 。 





JJ 项 目 发 发 可 危 ， 开 发 人 员 身 心 俱 疲 的 状态 。 
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2.2 案例 分 析 (第 1 天 ) 








某 天 早晨 你 去 公司 上 班 ， 觉 得 这 是 一 个 分 闽 的 早晨 ， 总 想 着 “好 讨 
大 啊 ”。 为 什么 会 觉得 厌烦? 因为 你 所 参加 的 项 目 陷 入 了 发 及 可 和 危 的 状 
况 ， 俗 称 “死亡 行军 ”。 

“但 仔细 想来 ， 不 是 死亡 行军 的 项 目 至 今 为 止 还 没有 遇 到 过 ”， 你 如 
此 思考 看 ,“ 可 哪里 出 问题 了 呢 ?” 你 边 想 边 去 上 班 。 











2.2.1 ”问题 1 : 重要 的 邮件 太 多 ， 无 法 确定 处 理 的 优先 顺序 


你 想 着 想 着 就 到 了 公司 ,打开 邮件 客户 端 ， 便 看 到 下 面 这 样 小 题 大 
作 的 邮件 主题 。 


eeeeeeee 





e 【重要 】 系 统 报错 导致 工作 无 法 进行 ， 请 立即 着 手 处 理 ! 

e【 加 急 】 正 式 环境 发 生 重 大 故障 ! 麻烦 立即 处 理 。 

e【 需要 处 理 】 客 户 环境 发 生 重 大 退化 。 请 尽快 处 理 。 

e 【 正式 环境 故障 】【 重要 】【 加 急 】【 立即 处 理 】 收 到 用 户 投诉 。 请 
立即 处 理 。 


看 到 这 些 五 花 八 门 的 邮件 主题 ， 虽 然 你 已 经 感到 烦躁 无 比 ， 但 还 是 
要 着 手 确 认 邮 件 的 内 容 。 但 是 所 有 的 邮件 主题 都 标 有 【重要 】 或 【加 
急 】 等 字样 ， 冤 全 不 知道 应 该 从 哪里 着 手 ， 所 以 只 能 依次 阅读 收 到 的 邮 
件 并 看 于 处 理 。 


2.2.2 ”问题 2 : 没有 能 用 于 验证 的 环境 





为 了 确认 邮件 中 反映 的 问题 ， 首 先 不 得 不 构建 和 发 生 故障 的 正式 环 
境 相 同 的 环境 。 因 为 这 个 项 目 一 开始 就 没有 准备 用 于 验证 的 环境 。 
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再 现 正 式 环境 中 发 生 的 问题 ， 必 须 首 先 再 现 与 正式 环境 相同 的 环 
境 。“ 要 是 有 一 直 和 正式 环境 保持 同步 状态 ”的 验证 用 的 环境 , 故障 的 再 
现 就 能 简单 多 了 ”你 一 边 想 着 ， 一 边 无 可 奈何 地 开始 在 本 地 机 器 上 搭建 
和 正式 环境 一 样 的 环境 。 








2.2.3 问题 3 : 用 别名 目录 管理 分 支 


由 于 到 昨天 为 止 一 直 在 开发 新 功能 ， 目 己 本 地 机 需 上 的 代码 和 正式 
环境 的 代码 已 经 相差 其 还 ， 所 以 只 好 将 本 地 机 右上 的 正在 开发 的 代码 所 在 
的 目录 重 命 名 为 “XXX new”， 再 从 版 本 管理 系统 下 载 最 新 的 代码 。 不 这 
样 的 话 ， 版 本 管理 系统 上 的 最 新 代码 就 会 和 本 地 的 代码 混淆 (图 2.1 )。 
图 2.1 将 目录 重 命 名 


‘a 人 


国 LocalApp 


国 LocalApp 没有 使 用 分 支 ( branch ) 进行 开发 
一 如 左边 这 样 ， 通 过 重 命名 本 地 目录 来 区 
十 LocalApp_New ( 最 新 ) | 分 个 同 的 代码 


六 LocalApp_Honban ( 正式 环境 的 副本 ) 


seeeeeeeseeeeeeeseeseseeeseeseeseeeseseeeeeeseeeeeseeeseeeseeeseeeee 




















~ 汉 
其 实 公 司 从 数 年 前 就 开始 使 用 版 本 管理 系统 了 ,但 由 于 开发 人 员 中 
没有 人 精通 版 本 管理 系统 的 使 用 方法 ， 所 以 并 没有 对 其 加 以 有 效 利用 。 
版 本 管理 系统 上 经 常 只 有 最 新 的 代码 。 那 是 因为 没有 有 效 地 利用 分 
文 功能 ， 为 了 区 分 本 地 机 需 上 的 代码 和 版 本 管理 系统 上 的 最 新 代码 ， 只 
能 用 给 目录 重 命名 这 种 方式 。 合 理 地 利用 版 本 管理 系统 就 应 该 能 解决 这 
些 问题 ， 但 又 不 知道 该 如 何 操作 。 加 上 因为 不 知道 标签 〈tag ) 的 使 用 方 
法 ， 发 布 时 的 系统 快照 也 没 能 保存 下 来 。 而 且 版 本 管理 系统 上 的 最 新 代 














由 实际 上 要 再 现 的 环境 包括 服务 器 台数 、 网 络 构成 以 及 数据 库 事务 数据 ， 但 要 将 全 
部 内 容 都 做 得 和 正式 环境 完全 一 致 是 非常 困难 的 。 本 书 中 指 的 是 应 用 程序 层面 上 
的 再 现 ， 也 就 是 指 程序 的 代码 、 数 据 库 模 式 (Schema )、 中 间 件 的 配置 等 。 
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码 还 有 可 能 已 经 和 正式 环境 的 代码 有 了 差异 ， 毕 苋 癌 正式 环境 进行 发 布 
经 是 两 周 前 的 事情 了 。 
因为 没有 使 用 标签 ， 所 以 正式 环境 发 布 的 版 本 对 应 版 本 管理 系统 中 
哪个 版 本 “已 经 无 从 知晓 。 没有 办 法 ， 只 能 麻烦 负责 运 维 的 人 将 正式 环 
境 的 代码 取 了 下 来 。 
自己 试 着 比较 了 最 新 的 代码 和 正式 环境 中 的 代码 ， 的 确 有 所 差异 “。 
在 最 新 代码 的 环境 中 ， 故 障 似 乎 已 经 无 法 表现 ( 图 2.2 )。 


图 2.2 ”正式 环境 和 开发 环境 产生 差异 


向 正式 环境 发 布 ， 由 于 其 他 开发 人 ”中 


























( 两 周 前 ) ， 员 的 这 两 次 提交 。 故障 败 生 的 时 候 ， 代 码 库 
代 可 座 ， 造 成 了 同 正式 环 ”的 最 新 状态 和 正式 环境 的 
区 ， 境 的 差异 状态 存在 差异 
， 发 布 时 故障 发 生 时 


ee en en enn een ap ee en en en en en en en en en en en en en en en en en en en en en en en en en en en en en ee 


“向 代 而 库 加 
1 提交 代码 本 地 机 器 上 的 这 3 个 提交 被 用 于 


新 功能 的 开发 ， 和 大 吕 订 以 及 正 








从 代码 库 全 
下 式 环境 都 不 相同 
—O—O——O—O—O— 


(因为 发 布 的 时 候 没 有 打上 标签 ， 
所 以 无 法 迅速 地 再 现 向 正式 环境 发 布 时 的 代码 库 快照 


(因为 开发 的 时 候 没 有 切换 分 支 ， 
所 以 当 本 地 代码 和 代码 库 产生 差异 时 ， 不 得 不 给 目录 重 命 


7/ 








QD) 这 里 使 用 了 “版 本 ”这 个 词 ， 在 Subversion 中 指 的 是 “版 本 号 ”(revision ), 在 
Git 中 指 的 是 “提交 哈 希 ”( commit hash )。 各 版 本 管理 系统 的 叫 法 不 相同 ， 所 以 
这 里 统称 为 “版 本 ”。 

@ 这 个 例子 假定 的 是 PHP 等 脚本 语言 。Java 或 C# 的 情况 下 ， 除 了 Play Framework 等 
一 部 分 情况 例外 ， 通 常 部 署 的 都 是 编译 后 的 二 进 制 文件 ， es 
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无 法 再 现 故障 的 代码 就 没有 意义 ， 所 以 你 决定 继续 使 用 从 正式 环境 
获取 的 代码 。 用 这 份 代码 在 本 地 机 各 上 构建 环境 可 不 是 一 件 容 易 的 事 
情 。 还 必须 保证 数据 库 模 式 和 正式 环境 完全 相同 ， 而 重新 制作 数据 库 也 
征 一 件 非常 麻烦 的 工作 。 





2.2.4 问题 4 : 重新 制作 数据 库 比 较 困 难 


为 了 使 数据 库 和 正式 环境 完全 相同 ， 需 要 下 载 版 本 管理 系统 的 代码 
库 中 的 SQL， 并 在 自己 的 开发 环境 上 构建 数据 库 。 刚 才 还 在 使 用 的 用 于 
新 功能 开发 的 数据 库 的 模式 已 经 和 正式 环境 的 数据 库 模 式 不 一 样 了 。 仔 
细 看 了 下 下 载 下 来 的 SQL， 总 觉得 有 一 些 SQL 并 不 适用 于 开发 环境 。 
不 知道 该 执行 哪些 SQL 才能 构建 和 正式 环境 完全 相同 的 数据 库 。 
否 有 必要 记录 下 执行 了 哪些 SQL 呢 ? 没 办 法 ,姑且 只 能 根据 推测 执 
了 SQL， 想 办 法 试 着 构建 环境 了 。 也 不 知道 是 否 能 正确 地 再 现 正式 环 
， 不 过 也 只 能 这 样 了 。 
数据 库 构建 完 后 ， 为 了 再 现 和 正式 环境 相同 的 状态 ， 还 需要 导入 数 
据 。 可 是 在 将 正式 环境 的 数据 "导入 刚才 构建 的 数据 库 时 ， 不 知 为 何 部 
分 数据 的 导入 失败 了 。 应 该 是 数据 库 模 式 不 同 的 原因 吧 。 总 觉得 正式 环 
境 的 模式 和 刚才 在 本 地 构建 的 模式 有 所 差异 。 虽 然 不 清楚 是 为 什么 ， 但 
鉴于 时 间 也 所 剩 无 几 了 ， 只 能 自己 用 眼睛 来 寻找 差异 ， 并 修改 SQL， 然 
后 重新 构建 数据 库 了 。 重 新 导入 数据 ， 这 次 终于 成 功 了 。 

代码 和 数据 库 都 准备 好 后 就 可 以 试 着 运行 程序 了 。 赶 紧 依 照 报告 中 
的 描述 操作 一 遍 ， 却 发 现 程序 无 法 正常 运行 ， 并 且 和 报告 中 描述 的 现象 
也 不 一 样 。 

为 了 再 现 故 障 而 试 着 搭建 环境 ， 但 因为 出 现 了 其 他 问题 ， 结 果 以 失 
败 告终 。 钨 怕 还 是 因为 数据 库 模 式 和 正式 环境 不 一 样 吧 。 以 为 仔细 点 就 
能 避免 上 述 问题 的 ， 结 果 还 是 不 行 。 没 办 法 ， 只 能 将 正式 环境 的 数据 库 


seeeeeeeseeeeeseeeseeseeeeseeseseeseseeeseeeseeeeseeeee 





























后 


流 
































QD) 这 里 的 数据 是 指正 式 环境 的 主 数据 (master data )。 关 联 数据 (transaction data ) 
因为 数据 量 过 大 ， 应 避免 直接 导入 本 地 环境 。 
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原封 不 动 地 复制 到 开发 环境 了 "。 

终于 搭建 好 了 和 正式 环境 完全 相同 的 环境 ， 突 然 发 现 已 经 是 中 午 
了 。 已 经 过 去 了 两 个 多 小 时 ， 可 是 连 邮件 中 反映 的 问题 是 否 能 再 现 都 还 
没 确认 。 

当天 下 午 和 同事 们 分 头 把 早晨 4 封 邮件 中 的 问题 全 部 再 现 了 ， 用 了 
1 天 的 时 间 修 正 这 4 件 bug， 并 将 其 提交 到 版 本 管理 系统 。 做 完 这 些 已 
经 快要 到 末班车 的 时 间 了 。 今天 一 整 天 都 在 忙 着 处 理 这 些 问 题 ， 本 来 应 
该 进行 的 新 功能 开发 也 完全 没有 着 手 。 算 了 ， 明 天 再 干 吧 ， 回 家 了 。 











(D 这 个 例子 中 ， 正 式 环境 的 数据 量 并 不 是 太 大 ， 所 以 可 以 复制 。 如 果 是 大 规模 服务 
的 话 ， 复 制 是 不 现实 的 。 为 了 避免 上 述 问题 ， 需 要 考虑 数据 库 的 管理 。 
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2.3 ”案例 分 析 ( 第 1 天 ) 中 的 问题 点 





看 了 死亡 行军 项 目 中 的 1 天， 感觉 怎么 样 ?“ 项 目 一 直 都 是 这 样 的 ， 
已 经 习惯 了 ”是 不 是 也 有 人 这 么 想 呢 ? 

反思 第 1 天 中 发 生 的 事情 ， 让 我 们 一 起 来 确认 下 到 底 哪 里 有 问题 ， 
哪里 做 得 不 够 好 。 














eeeeeeee 


2.3.1 ”问题 1 : 重要 的 邮件 太 多 ， 无 法 确定 处 理 的 优先 顺序 


这 个 项 目 中 没有 对 谍 题 进行 管理 的 机 制 〈 缺 陷 管 理 系统 )， 所 以 只 
能 通过 邮件 来 发 送 有 关 bug 或 故障 的 报告 。 加 上 邮件 的 主题 中 写 有 【 重 
要 儿 加 急 儿 需要 处 理 】 这 样 的 标题 头 ， 所 有 的 邮件 都 变 得 很 重要 ， 不 
知 违 应 该 从 何 处 开始 着 手 处 理 。 这 样 的 邮件 满天飞 的 开发 现场 你 有 没有 
行 过 呢 ?“ 遇 到 过 遇 到 过 ”似乎 还 能 听 到 这 样 的 回答 。 

不 使 用 缺陷 管理 系统 ， 而 通过 邮件 进行 交流 会 有 哪些 问题 ? 下面 就 
来 列 圭 一。 














e…… 邮件 的 数量 太 多 ， 导 致 重要 的 邮件 被 埋没 


大 家 在 开发 现场 1 天 之 中 所 收发 的 邮件 数量 大 概 有 多 少 呢 ”当然 数 
量 会 根据 公司 的 规模 和 职位 有 所 不 同 。 以 笔者 为 例 ， 笔 者 之 前 所 在 的 公 
司 中 ， 与 自己 所 参与 的 项 目 相 关 的 邮件 以 及 其 他 邮件 加 起 来 ，1 天 之 中 
大 约 要 收 到 300 一 400 封 邮 件 。 该 公司 的 规模 未 满 100 人 ， 参 与 项 目 开 
发 的 人 员 在 10 人 左右 。 笔 者 当时 还 兼任 部 门 主管 ， 所 以 会 有 人 事 相 关 
的 邮件 以 及 其 他 的 一 些 被 抄 送 的 邮件 ， 这 也 是 邮件 比较 多 的 原因 之 一 。 

也 就 是 说 ， 参 加 项 目的 人 员 不 可 能 都 专门 进行 这 一 个 项 目 ， 其 中 很 
多 都 还 有 其 他 的 日 常 业 务 ， 或 者 兼任 着 其 他 项 目的 工作 。 因 此 必然 会 产 
生 大 量 的 邮件 ， 造 成 重要 的 邮件 被 埋没 ， 容 易 被 漏 看 。 
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为 了 让 目 己 的 邮件 不 被 独 掉 ， 很 多 人 都 会 在 邮件 的 主题 前 加 上 之 前 
列举 的 那些 标题 尖 。 但 是 因为 没有 统一 的 规则 ， 完 苋 哪 些 是 重要 的 无 从 
知晓 。 结 来 还 是 被 埋没 在 了 成 堆 的 邮件 中 ， 次 加 的 标题 头 也 完全 失去 了 
意义 。 





@…… 无 法 进行 状态 管理 











因为 邮件 并 非 是 用 来 管理 课题 或 任务 的 软件 ， 所 以 不 能 对 其 状态 进 
行 管理 。 哪 个 诛 题 已 经 结束 了 ， 哪 个 评 题 还 在 进行 中 ， 或 者 是 验证 不 通 
过 被 退回 来 了 ， 这 些 和 都 无 法 简单 地 获知 。 如 果 不 耐心 地 一 封 一 封地 阅读 
同一 主题 的 往来 邮件 ， 驶 不 知道 究竟 是 怎样 的 问题 。 有 时 承 算 读 到 了 最 
后 ， 因 为 来 来 回回 的 交互 过 于 错综复杂 ， 完 竟 络 局 怎样 也 还 是 不 清 药 。 
这 也 是 钊 有 的 事 。 




















e@…… 直观 性 、 检 索性 较 弱 


这 一 问题 同上 一 个 问题 是 相关 的 ， 那 就 是 用 邮件 进行 管理 在 直观 性 
和 检索 性 方面 也 比较 弱势 。 邮 件 中 包含 了 很 多 和 项 目 没有 直接 关系 的 内 
容 ， 想 看 只 包括 谍 题 的 列表 ， 这 样 的 要 求 佑 计 无 法 实现 。 检 索 也 是 这 
样 。 也 可 以 使 用 像 Gmail 这 样 的 邮件 应 用 程序 ， 但 像 这 样 用 全 文 检索 来 
查找 诛 题 可 以 次 实在 是 效率 太 低 了 。 

















@@…………. 用 邮件 来 管理 项 目的 课题 


总 结 一 下 上 述 内 容 就 是 : 邮件 的 可 视 性 不 佳 ， 难 以 进行 优先 度 或 重 
要 度 的 判断 ， 并 且 无 法 进行 状态 管理 ， 不 文 持 显示 课题 列表 、 检 索 等 ， 
所 以 作为 管理 项 目 状况 的 工具 来 说 ， 功 能 上 是 不 足 的 。 

项 目 混乱 是 由 于 茶 些 问题 造成 的 ， 其 中 一 个 比较 严重 的 问题 就 是 这 
里 列举 的 没有 共享 信息 及 有 效 管 理 诛 题 的 机 制 。 

上 述 问题 可 以 考虑 通过 导入 缺陷 管理 系统 来 解决 。 本 书 的 第 4 章 将 
讲解 在 使 用 了 缺陷 管理 系统 的 项 目 中 任务 管理 和 bug 管理 的 方法 。 
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2.3.2 ”问题 2 : 没有 能 用 于 验证 的 环境 


没有 能 用 于 验证 的 环境 可 以 说 是 一 个 大 问题 。 在 收 到 项 目 正式 环境 
中 发 生 的 故障 报告 后 ， 下 载 代码 并 搭建 开发 环境 的 做 法 每 次 都 要 花费 较 
长 时 间 。 

只 要 不 影响 新 功能 开发 的 任务 不 就 没事 了 ? 但 现实 往往 没 这 么 简 
单 。 除 了 发 布 后 的 正式 环境 之 外 ， 一 般 还 有 为 下 一 次 发 布 做 准备 的 ， 还 
在 验证 中 的 staging 环境 ”， 其 至 还 有 为 下 下 次 发 布 准 备 的 环境 。 

新 功能 开发 过 程 中 有 了 时 不 得 不 调查 正式 环境 中 发 生 的 一 些 故障 。 如 
果 有 一 直 和 正式 环境 保持 一 致 的 staging 环境 那 就 最 好 了 ， 但 因为 环境 
的 搭建 实在 是 件 非常 麻烦 的 事情 。 要 怎样 做 才能 提高 效率 呢 ? 

有 方法 能 够 搭建 持续 、 自 动 地 向 验证 环境 、staging 环境 以 及 正式 环 
境 进 行 发 布 ， 并 一 直 保持 正常 运行 的 环境 ， 本 书 的 第 6 章 中 将 进行 这 方 
面 的 讲解 。 


AAA 

















2.3.3 问题 3 : 用 别名 目录 管理 分 支 


这 个 项 目 虽 然 使 用 了 版 本 管理 系统 ， 但 不 能 说 对 其 进行 了 有 效 的 利 
用 。 以 前 连 版 本 管理 系统 都 不 使 用 的 开发 现场 随处 可 见 ， 现 在 使 用 版 本 
管理 系统 的 开发 现场 比较 多 了 。 但 是 如 同 这 个 项 目 一 样 ， 版 本 管理 系统 
没有 得 到 充分 利用 的 情况 却 意 外 地 多 。 

使 用 版 本 管理 系统 是 为 了 管理 什么 时 候 、 谁 、 做 了 怎样 的 修改 〈 提 
区 记录 的 管理 )， 以 及 能 恢复 到 过 去 茶 个 时 间 点 的 状态 〈 分 文 、 标 签 的 
管理 )。 这 个 项 目 中 没有 很 好 地 使 用 版 本 管理 系统 的 重要 功能 一 一 分 文 
和 标签 ， 所 以 无 法 从 新 功能 开发 的 版 本 顺利 地 切换 到 有 故障 报告 的 已 经 


seeeeeeeeeeeeeeseseeeseeeeseeseeeeeeeseeeseeeeeeeeseeeeeeeeeee 




















(D 这 里 的 staging 环境 是 指 介 于 开发 环境 和 正式 环境 之 间 的 测试 环境 ， 即 正式 环境 
发 布 前 用 于 验证 的 环境 。 本 书 中 将 staging 环境 用 于 再 现 和 验证 在 正式 环境 中 发 
生 的 故障 。 根 据 环境 的 体系 不 同 ， 也 有 和 正式 环境 保持 完全 一 致 ， 仅 在 发 布 前 用 
于 动作 确认 的 staging 环境 。 在 这 样 的 情况 下 ， 除 了 staging 环境 之 外 ， 还 会 另行 
准备 测试 环境 。 环 境 搭建 包括 运 维 在 内 是 一 笔 不 小 的 开销 ， 所 以 在 体系 以 及 项 目 
预算 允许 的 范围 内 ， 最 合理 地 构建 环境 是 很 重要 的 。 
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发 布 的 版 本 。 只 能 临时 将 本 地 机 各 上 的 目录 重 命 名 。 也 就 是 说 ， 本 来 应 
该 交 由 版 本 管理 系统 负责 的 分 文 管 理 ， 现 在 由 人 在 本 地 机 硕 上 手动 地 进 
‘a 

恋 过 前 文 的 读者 想必 都 知道 了 ， 用 给 日 录 重 命名 的 方法 修改 完 bug 
后 回 到 新 功能 的 开发 ， 之 后 骨 一 次 回 到 bug 修改 ， 在 这 样 反 复 地 进行 重 
命名 的 过 程 中 ， 很 容易 出 现 问题 。 

那么 到 底 该 如 何 使 用 版 本 管理 系统 呢 ? 版 本 管理 系统 的 分 文 、 标 签 
这 样 的 功能 如 何 使 用 才 是 有 效果 的 呢 ? 

这 个 问题 还 关系 到 今后 程序 以 怎样 的 周期 、 怎 样 的 方式 进行 发 布 ， 
本 书 将 在 第 3 章 进行 这 方面 的 讲解 。 

















2.3.4 问题 4 : 重新 制作 数据 库 比较 困难 


在 构建 staging 环境 或 正式 环境 时 比较 容易 出 问题 的 是 数据 库 的 处 
理 。 虽 然 没 有 对 数据 库 的 修改 进行 管理 的 项 目 比 较 稼 见 ， 但 这 个 项 目 还 
是 使 用 版 本 管理 系统 对 SQL 文件 进行 了 管理 的 。 

这 样 就 会 经 常 出 问题 。 比 如 不 知道 在 什么 环境 中 该 使 用 哪些 SQL ， 
从 而 导致 没有 察 党 到 簿 漏 了 某 些 SQL。 还 有 在 多 个 人 修改 数据 库 的 情况 
下 ， 不 知道 该 如 何 管理 才能 避免 修改 冲突 。 

那么 这 个 项 目 到 底 会 怎么 样 呢 ? 

首先 ， 版 本 管理 系统 上 ， 有 如 下 的 SQL 被 提交 。 


版 本 管理 系统 上 
展 全 允 业 有 
提交 者 :ikeike443 
cnceateemus en eu 
CREATE TABLE Use 
id SERIAL NOT NULL, 
name VARCHAR NOT NULL, 
email VARCHAR NOT NULL 
) ; 





Rev2: 本 地 环境 中 遗漏 
扣 广 老 、> nori 
so Golunan SocL 
ALTER TABLE User ADD COLUMN Some flag INTEGER:， 
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ER 
提交 者 : ikeike443 
weermaelonmalolonessss el 
ALTER TABLE User ADD COLUMN address VARCHAR.,; 


ReV4 : 
提交 者 : okamura 
eaelems el 


ALTER TABLE User ADD COLUMN tel VARCHAR; 


对 应 上 述 SQL， 本 地 开发 环境 和 正式 环境 的 模式 如 图 2.3 所 示 。 
图 2.3 本 地 开发 环境 和 正式 环境 的 模式 


1 、 


id | name | email |address| tel 











E 





name |some flag| email |address 


[| tel | 











ikeike443 的 本 地 环境 中 遗漏 了 Rev (Revision ) 2 的 add column. 
sql， 只 执行 了 create user.sql 和 user add address.sql。 但 因为 没有 注意 
到 这 点 并 继续 执行 了 之 后 的 tel add.sql|， 所 以 就 和 正式 环境 产生 了 差异 。 
上 述 例子 中 是 用 眼睛 看 出 数据 库 模 式 上 的 差异 后 ， 手 工 制作 了 相当 








于 add_column.sql 的 文件 并 执行 的 。 但 结果 还 是 出 现 了 原因 不 明 的 运行 时 
错误 。 于 是 只 好 放弃 ， 转 而 从 正式 环境 复制 所 有 的 数据 重新 构建 环境 。 

这 个 谜 一 般 的 运行 时 错误 的 原因 是 什么 呢 ? 

这 是 因为 本 地 开发 环境 和 正式 环境 中 ALTER 语句 的 执行 顺序 不 同 ， 
造成 了 列 的 定义 顺序 和 最 新 代码 不 匹配 ( 图 2.4 )。 根 据 代码 的 写法 以 及 
对 旬 关 系 映 射 ( O/R mapping ) 的 实现 的 不 同 ， 有 时 会 出 问题 ， 有 时 也 
可 能 没有 问题 。 但 关键 问题 在 于 因为 没有 制定 构建 数据 库 的 方法 ， 所 以 
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无 法 构建 出 能 够 保证 正常 运行 的 环境 。 
2.4 执行 的 顺序 不 同 





| 





name |some flag| email |address 


要 怎么 做 才能 解决 这 样 的 问题 呢 ? 
第 3 章 中 将 讲解 用 版 本 管理 系统 管理 SQL 的 方法 以 及 处 理 数据 库 
变更 管理 的 工具 。 
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2.4 案例 分 析 (第 2 天 ) 


接着 来 看 一 下 项 目 第 2 天 中 发 生 的 事情 。 项 目 会 怎么 样 呢 ? 


2.4.1 问题 5 : 不 运行 系统 就 无 法 察觉 问题 


第 二 天 早上 ， 刚 坐 到 椅子 上 准备 继续 开发 新 功能 时 ,测试 人 员 来 到 
本 你 的 座位 前 。 说 是 昨天 提交 的 版 本 有 问题 。 在 提交 的 4 个 bug 中 ， 能 
够 确认 其 中 3 个 已 经 得 到 了 修正 , 但 为 外 1 个 还 是 有 问题 。 

并 且 还 有 报告 说 发 生 了 退化 ， 以 前 修正 好 的 bug 因为 这 次 的 修改 又 
再 次 出 现 了 。 可 昨 晚 明明 目 己 和 组 员 一 起 努力 把 邮件 中 提 到 的 4 个 bug 
者 修正 并 提交 了 啊 ， 而 且 还 在 各 目的 环境 中 对 修正 进行 了 确认 呢 。 

不 过 重新 回想 一 下 的 话 ， 确 实 没 有 将 全 员 的 代码 集中 到 一 起 运行 
过 。 因 为 在 测试 人 员 的 环境 中 是 第 一 次 将 所 有 的 修改 合并 到 一 起 运行 
的 ， 所 以 就 出 现 了 上 述 状况 。 














2.4.2 ”问题 6 : 覆盖 了 其 他 组 员 修 正 的 代码 


下 载 最 新 的 代码 并 运行 ， 发 现 确 实 如 测试 人 员 所 说 : 3 个 修正 了 ， 
1 个 没有 修正 ， 并 且 过 去 修正 了 的 bug 又 复活 了 。 你 觉得 实在 是 很 奇怪 ， 
就 看 了 下 代码 库 的 提交 记录 "。 


revVv: 245 








Author: ikeike443 <ikeike443@gmail .com> 
Deses: MG 而 DC.00 


修正 了 发 送 邮 件 的 逻辑 


rev: 244 


Author: okamura <hogehoge@gmail .com> 


@Q 这 里 以 Subversion 为 例 。 
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Date : Me@OmeDeece 2045 二 0900 


修正 了 申请 时 扣 款 处 理 失败 的 问题 


EN 2 人 过 
Author: ikeike443 <1IKelke443@gmalil1 .com> 
Dases: 殿后 前， 全 他 ss S000 


修正 了 某 些 时 间 点 无 法 进行 申请 处 理 的 bug 


Rev244 和 243 都 修改 了 申请 处 理 相 关 的 部 分 ， 觉 得 这 里 有 些 奇 怪 ， 





就 查看 了 下 Diff*， 才 发 现 你 在 Rev243 中 提交 的 修改 被 Rev244 覆盖 掉 了 。 


你 所 提交 的 修改 如 下 所 示 





Rev243 和 Rev244 的 Diff ( 在 Rev243 中 增加 的 修改 ) 


if (uger,. SEatEu == 3) 1 
aloroalniee onsen 
} else { 
// 考 虑 到 用 户 状态 是 Nul1 的 情况 
if(user.status != null && user.status == ) 


司 辣 | 避 elaie nl 
} else 1{ 


这 个 修正 被 之 后 的 提交 上 绪 普 ， 如 下 所 未 。 








Rev243 和 Rev244 的 Diff ( 在 Rev244 中 增加 的 修改 ) 


// 考 虑 到 用 户 状态 是 Nul1 的 情况 


++++ + + + + 


日 OO 


if(user.status != null && user.status == 3) { 
looming 

} else 1{ 

// 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 

if(user.status == 3 && user.useCredit == true) 1{ 


alolon eel omnes 


ln Neneleb see us 三 巴 5 
billing.execute(); 


} else 1{ 


原 指 比 较 文件 并 输出 文件 之 间 的 差异 的 程序 。 这 里 指 差异 本 身 。 


这 段 代 码 自身 原本 就 有 如 下 列举 的 这 些 问题 。 有 必要 从 根本 上 提高 代码 的 质量 。 
e@ 使 用 了 魔 数 (magic number ) 

@ 没 有 确认 application.submit 的 返回 结果 

@ 没 有 处 理 异 常 

@ 代码 的 实现 有 副作用 ( side effect ) 
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在 Rev243 中 特地 加 上 的 userstatus 的 Null 检查 ,被 Rev244 覆盖 后 
Null 检查 就 没有 了 。 为 什么 会 发 生 这 样 的 事情 呢 ? 

结果 ， 原 以 为 已 经 修正 的 bug 还 是 有 问题 ， 原 因 是 代码 被 履 盖 而 造 
成 了 退化 “。 向 覆盖 代码 的 开发 者 询问 事情 的 缘由 ， 对 方 却 只 是 回答 道 : 
“向 代码 库 提交 在 自己 的 本 地 环境 中 修正 的 代码 时 发 生 了 冲突 ( conflict )”， 
我 只 是 把 冲突 改 挥 了。” 

这 时 你 很 想 斥 责 对 方 :" 那 是 你 修正 冲突 的 方法 有 问题 ! ”但 还 是 控制 
住 了 目 己 的 脾气 ， 包 括 那 个 开发 着 的 修正 在 内 ， 你 对 代码 做 了 如 下 修正 。 





























Rev245 和 最 新 的 Rev246 的 Diff ( 这 次 的 修正 ) 
- // 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 


- if(user.status == 3 && user.useCredit == true) { 


到 anelleamone senor 


- la Nene el ns 
- billing.execute(); 


- } else { 
// 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 
// 考 虑 到 用 户 状态 是 Nul11 的 情况 
if (user.status != null && 
user.status == 3 && user.useCredit == true) 1{ 
avilicatlicon. SuomLt ()s 


loutne Nene ease us us: 
billing.execute(); 


+++++++ + + + 


} else 1{ 


2.4.3 ”问题 7 : 无 法 目 信 地 进行 代码 重 构 


这 么 修改 姑且 合并 ( Merge ) “成 功 了 ,但 因为 if 语句 发 生 了 变化 ， 
所 以 程序 的 动作 也 会 发 生变 化 。 这 时 你 觉得 进行 一 下 代码 重 构 比 较 好 ， 
但 是 却 没有 信心 能 够 在 确保 不 发 后 退化 的 情况 下 进行 代码 重 构 。 没 有 办 


eeeeeeeeseeeeeeseeeseeeseeeeseseeeseeeeseeseeeeee 








(DD “userstatus != null” 这 一 部 分 。 可 见 在 Rev244 中 被 删除 了 。 

@ 由 于 添加 功能 或 者 修改 bug 而 造成 其 他 已 经 实现 了 的 功能 无 法 运行 或 速度 变 慢 的 现 
象 。 这 次 出 现 的 现象 是 ， 因 为 Rev244 的 修正 使 得 Rev243 中 修正 的 代码 被 复原 了 。 
对 同一 处 代码 进行 了 不 同 的 修改 ， 造 成 了 代码 修改 冲突 。 

将 多 件 物 品 整 合 到 一 起 。 


© © 
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法 ， 只 能 增加 让 条 件 ， 用 条 件 分 支 来 处 理 。 





Rev245 和 最 新 的 Rev246 的 Diff ( 重 写 了 这 次 的 修正 ) 
- // 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 


- if(user.status == 3 && user.useCredit == true) { 


= ISRC 本 En 全 是 


- lo Yenc ene 三 巴 7 
- lpaunleme eeeneen 


} else 1{ 

// 使 用 信用 卡 的 用 户 的 情况 下 ， 在 申请 的 同时 进行 扣 款 处 理 

// 考 虑 到 用 户 状态 是 Nu11 的 情况 

if (user.status != null && 
user.status == 3 && user.useCredit == true) { 
adolieaeELon. SuomLie()s 


lean en Ss 三 二 7 
billing.execute(); 


// 不 使 用 信用 卡 的 用 户 的 情况 下 

} else if(user.status != null && user.status == ) 
lrmoore 

} else 1{ 


至 此 昨天 发 生 的 4 个 bug 应 该 都 修正 好 了 。 为 避免 测试 人 员 再 像 今 
天 后 上 那样 不 给 你 好 脸色 看 ， 所 以 重新 对 所 有 的 用 例 进 行 测 试 。 疫 有 准 
备 目 动 测试 环境 ， 只 能 手动 进行 测试 。 测 试 结果 没有 问题 ， 程 序 也 能 
第 运行 ， 所 以 就 把 代码 提交 了 了 。 


+ 二 十 二 十 二 十 二 二 十 二 十 十 | 





2.4.4 ”问题 8 : 不 知道 bug 的 修正 日 期 ， 也 不 能 追踪 退化 





eeeeee 


还 有 一 件 事 情 : 过 去 的 bug 又 出 现 了 。 这 究竟 是 怎么 回 事 呢 ? 向 测 
试 人 员 问 了 下 这 个 bug 原本 是 什么 时 候 发 生 的 ， 具 体 是 怎样 的 bug， 回 
答 说 是 大 约 半 年 前 下 接收 到 客户 的 邮件 后 ， 让 其 他 开发 人 员 修 正 了 的 
bug。 直 到 现在 才 第 一 次 听 说 这 件 事情 。 过 去 修正 了 的 bug 再 度 发生 ， 
可 以 说 是 发 生 了 退化 ， 当 然 不 可 能 就 这 样 进行 发 布 。 

没 办 法 ， 只 能 让 测试 人 员 把 过 去 的 邮件 翻 出 来 ， 找 出 和 用 户 交 流 的 
内 容 。 根 据 好 不 容易 才 找 到 的 邮件 日 期 ， 在 版 本 管理 系统 的 代码 库 中 查 
找 对 应 的 提交 版 本 ,再 和 当时 负责 修改 的 开发 人 员 一 起 来 确认 ， 终 于 找 
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到 了 当时 的 提交 版 本 。 

但 似乎 这 个 提交 在 大 约 3 个 月 之 前 束 被 其 他 的 修正 发 布 履 盖 掉 了 。 
正式 环境 发 生 退 化 长 达 3 个 月 之 久 ， 期 间 谁 部 没有 察觉 出 来 ， 这 实在 是 
非常 粳 料 的 情况 。 这 次 能 够 在 客户 提出 之 前 发 现 ， 实 在 是 不 钼 中 的 万 池 。 

重新 修正 并 提交 。 想 着 这 下 应 该 没 问 题 了 ,但 还 是 觉得 不 安心 ,于 
是 再 次 手动 进行 了 测试 ， 确 认 退 化 已 经 被 修正 了 。 

啊 ! 差点 忘 了 ， 昨 天 发 生 的 4 个 bug 的 修正 没关系 吧 。 修 正 了 过 去 
的 退化 ， 却 导致 了 别 的 退化 发 生 ， 这 可 不 是 曾 着 玩 的 。 想 到 这 里 ， 再 次 
对 4 个 bug 进行 了 测试 。 这 次 确实 没 问题 了 ， 于 是 提交 了 代码 (图 2.5 )。 
图 2.5 至今 为 止 的 提交 状况 


全 、 























ee a Rev Rev Rev Rev 
八 1 人 1 


O—X 
半年 前 被 别 的 提交 


的 bug ”所 履 次 Rev243 被 4 


4 一 全 X 











Rev244 覆盖 
申请 处 理 的 ， 
bg 申请 时 的 ;| 
在 Rev246  ， 
中 复原 、， 
Ne 到 





2.4.5 ”问题 9 : 没有 灵活 使 用 分 支 和 标签 


在 这 样 那样 的 “斗争 ”中 ， 不 知 不 觉 已 经 是 傍晚 了 。 本 来 应 该 做 的 
新 功能 开发 还 没有 开始 动手 。 总 觉得 每 天 都 在 干 同样 的 事 。 

不 管 怎 么 说 总 算 告 一 段落 了 ， 该 回 到 新 功能 的 开发 上 了 。 用 昨天 重 
命名 的 日 录 ， 重 新 开始 开发 。 

稍 等 一 下 ， 从 昨天 开始 斗争 了 两 天 的 bug 修正 会 怎么 样 ? 如 果 就 这 
样 在 昨天 的 目录 的 基础 上 进行 新 功能 开发 ， 并 提交 到 版 本 管理 系统 的 代 
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码 库 中 的 话 ,感觉 还 是 会 发 生 大 范围 的 退化 "。 真 是 太 险 了 。 你 注意 到 了 
这 点 ， 开 始 将 昨天 的 修正 合并 到 手头 的 新 功能 开发 版 本 中 (图 2.6)。 幸 
运 的 是 合并 操作 可 以 使 用 工具 机 械 地 进行 ， 但 编译 却 出 了 问题 ”。 


图 2.6 没有 忘记 对 修改 进行 合并 ,但 .…… 














6 \ 
正式 环境 
* 
“和 正式 环境 ; 未 是 因为 其 他 组 员 
发 布 ””“， 的 这 两 个 提交 ， 本 
代码 库 (2 周 前 ) ee 
' 差异 
， 个 发 布 的 时 间 点 下 放生 * * * * * : 
OO | Re 
， “向 代码 库 提交 向 代码 库 
Ge | 从 正式 环境 ， ! ! ! ! 近 交 
ee. 复制 代码 “， 
1 ' RevRevRevRevRev 


和 243 244 245246247 





. = ' ( 这 次 修正 的 部 分 ) 


从 代码 库 ， 。' 半 功能 开发 方面 的 提交 
下 载 ， ， 人 RevRevRevRevRev 


| pg 243244 245 246 247 
0 








> 
Xe 








一 边 发 愁 一 边 继续 修改 ， 终 于 编译 是 能 通过 了 ， 但 确认 上 昨天 之 前 的 
程序 动作 是 否 正常 时 却 遇 到 了 困难 ， 因 为 昨天 的 事情 几乎 已 经 不 记得 
了 。 和 总 算 编 译 也 通过 了 ， 程 序 也 能 运行 了 ， 觉 得 应 该 没有 问题 ， 于 是 就 
者 于 继续 新 功能 的 开发 了 。 

虽然 也 党 得 正 是 因为 反复 出 现 这 样 的 事情 才 导 致 了 现在 的 状态 ， 但 

















Q) “如 果 合 理 使 用 Subversion 或 Git 等 版 本 管理 系统 的 话 就 不 会 发 生 这 样 的 事情 ”， 
你 的 这 一 想法 是 正确 的 。 

@ 聪明 的 读者 可 能 已 经 注意 到 了 ， 因 为 忘记 了 合并 图 2.6 的 “代码 库 ” 部 分 中 的 
“ 别 的 组 员 的 两 个 提交 ”， 所 以 发 生 了 编译 错误 。 没 有 合理 地 对 分 支 进 行 管理 ， 就 
会 发 生 这 样 的 事情 。 
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却 不 知道 应 该 怎么 做 。 就 这 样 怀 揣 着 说 不 清 的 不 安 ， 继 续 回 到 了 工作 中 。 


2.4.6 ”问题 10 : 在 测试 环境 、 正 式 环 境 上 无 法 运行 





夜幕 降临 ， 新 功能 的 编码 工作 终于 步 和 人 了 正轨 ， 这 时 测试 人 员 发 来 
消息 ， 说 刚才 提交 的 版 本 在 staging 环境 的 特定 条 件 下 无 法 正常 运行 。 
没 办 法 ， 只 好 和 测试 人 员 一 起 对 staging 环境 进行 了 确认 。 

的 确 ， 程 序 自身 启动 起 来 了 ， 过 去 bug 的 退化 也 确认 修正 了 ,但 其 
他 的 功能 却 出 现 了 “Internal Server Error”。 刚 才 明 明 在 本 地 确认 过 了 ， 
为 什么 还 会 出 现 错误 呢 ? 

于 是 决定 在 本 地 环境 上 确认 同样 的 操作 。 但 由 于 现在 本 地 机 厦 上 的 
开发 环境 是 新 功能 开发 用 的 环境 “, 因此 只 能 再 一 次 重 命 名 目录 , 回 到 刚 
才 还 在 使 用 的 修正 bug 用 的 目录 中 进行 确认 。 

在 本 地 机 右上 确认 动作 ， 没 有 发 现 问题 ， 可 以 正常 运行 。 应 该 是 本 
地 环境 和 staging 环境 有 什么 地 方 不 一 样 吧 。 这 时 突然 想 了 起 来 ， 昨 天 
修正 bug 的 时 候 添 加 了 新 的 库 ， 而 staging 环境 上 还 没有 安装 过 新 添加 
的 库 。 

的 确 ， 在 本 地 确认 完 后 ， 蕊 记 让 测试 人 员 安 装 库 了 。 用 邮件 将 本 地 
安装 的 库 发 送 给 测试 人 员 进 行 安装 后 ，staging 环境 能 正 浓 运行 了 。 总 算 
松 了 口气 ,但 觉得 这 么 下 去 不 是 个 办 法 ， 难 道 没有 更 有 效 的 方法 来 管理 
库 ， 并 且 能 防止 遗漏 吗 ? 












































2.4.7 ”问题 11 : 发 布 太 复杂 ， 以 至 于 需要 发 布 手 册 


总 算 staging 环境 上 的 测试 也 OK 了 ， 准 备 回 正式 环境 进行 发 布 。 由 
于 发 生 了 之 前 遗漏 库 的 问题 ， 负 责 发 布 的 人 员 要 求 你 提供 发 布 手册 。 于 
征 你 就 和 测试 人 员 一 起 制作 了 发 布 手册 ， 并 在 制作 过 程 中 特别 留意 了 以 
下 上 邢 种 O 〇 








网 站 服务 器 内 部 发 生 的 错误 。 
@) 为 了 保险 起 见 进行 确认 时 ， 发现 该 项 目 中 没有 用 于 验证 的 环境 ， 所 以 只 能 在 本 地 
机 器 上 通过 目录 重 命名 的 方式 来 验证 。 
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e 应 该 下 载 版 本 管理 系统 的 代码 库 中 的 哪个 版 本 
e 应 该 如 何 更 新 DDL、 依 赖 的 库 以 及 配置 文件 





每 次 都 需要 与 这 样 的 手册 。 有 没有 什么 更 高 效 的 做 法 呢 ? 

因为 这 次 的 发 布 中 包括 重大 的 bug 修正， 作为 开发 者 的 你 被 要 求 一 
同 在 场 。 每 次 发 布 都 要 花费 一 天 的 时 间 ， 彻 夜 进行 。 虽然 你 有 些 不 情 
愿 ， 但 也 没有 办 法 。 今 晚 看 来 是 回 不 去 了 。 

在 彻夜 的 发 布 作业 中 间 题 频 发 。 正 式 环境 的 数据 库 由 于 经 历 了 至 今 
为 止 的 开发 过 程 ， 已 经 和 测试 环境 以 及 staging 环境 有 了 很 大 的 差异 ， 
只 能 通过 手动 修改 来 处 理 。 配 置 义 件 也 是 只 有 正式 环境 的 写法 不 一 样 ， 
不 得 不 一 边 谨慎 地 用 肉眼 核对 ， 一 边 进行 合并 。 

所 依赖 的 库 的 版 本 不 一 样 的 情况 也 有 很 多 。 为 了 让 正式 环境 运行 起 
来 ， 知 要 很 多 有 突 外 的 作业 ， 并 且 这 些 作 业 的 内 容 没 有 被 记录 在 版 本 管理 
系统 中 ， 所 以 灵 怕 下 一 次 发 布 的 时 候 还 是 会 发 生 同 样 的 问题 。 

就 这 样 ， 死 亡 行车 仍 在 继续 。 
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2.5 ”案例 分 析 ( 第 2 天 ) 中 的 问题 点 


让 我 们 一 起 来 反思 一 下 第 二 天 中 发 生 的 事情 。 





2.5.1 问题 5 : 不 运行 系统 就 无 法 察觉 问题 


eeeeeeseeeeseeeseseeeeeseseseeeeeeeeseee 


这 个 例子 中 到 底 发 生 了 些 什 么 呢 ? 

前 一 天 几 个 人 分 头 修 正 了 4 个 bug。 但 第 二 天 早上 全 员 的 修正 代码 
合并 到 一 起 测试 时 ，4 个 bug 中 只 有 3 个 被 修正 了 ， 并 且 过 去 的 bug 还 
发 生 了 退化 。 如 有 果 开 发 人 员 没 有 说 谎 的 话 ， 那 么 就 有 可 能 是 修正 的 内 容 
互相 发 生 了 干扰 。 

在 这 个 例子 中 ， 版 本 管理 系统 使 用 方法 不 正确 是 造成 他 人 的 修改 内 
容 被 覆盖 并 消失 的 主要 原因 。 仔 细 地 跟踪 调查 版 本 管理 系统 中 的 提交 记 
录 ， 就 能 够 彻底 地 弄 清原 因 。 

但 这 里 的 问题 是 : 到 发 现 问题 时 ， 已 经 过 去 了 一 天 一 夜 。 等 到 发 现 
过 去 修正 的 bug 的 退化 ， 那 经 过 的 时 间 就 更 长 了 。 

假如 因为 儿 个 月 前 的 修正 而 发 生 了 退化 ， 那 么 追查 提交 记录 并 查 明 
原因 大 概 需 要 多 久 的 时 间 呢 ?请 试 着 想象 一 下 。 这 时 你 可 能 连 想 都 不 愿 
意 想 ， 更 别提 去 做 了 。 难 道 就 没有 办 法 早 一 点 发 现 这 个 问题 吗 ? 

每 次 加 版 本 管理 系统 提交 更 新 时 ， 都 对 程序 整体 是 否 能 正常 build、 
已 有 的 功能 是 否 正常 运行 进行 检查 不 就 可 以 了 吗 ? 

这 样 的 想法 称 为 持续 集成 ( CI)。 这 是 将 团队 成 员 的 修改 等 所 有 项 
目 相 关 的 资源 集中 到 一 起 进行 集成 ， 并 经 党 、 持 续 地 确认 build 及 测试 
是 否 通过 的 一 种 实践 。 

CI 相关 的 内 容 将 在 第 $ 章 中 进行 讲解 ， 用 CI 实现 高 效 的 回归 测试 
相关 的 内 容 将 在 第 7 章 中 进行 讲解 。 
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2.5.2 ”问题 6 : 覆盖 了 其 他 组 员 修 正 的 代码 


多 人 开发 程序 时 会 发 生 因 修改 的 代码 重 半 而 产生 冲突 的 现象 。 发 生 
冲突 的 情况 下 ， 要 在 保证 双方 修改 都 能 正常 运行 的 前 提 下 进行 合并 ， 
但 要 正确 地 进行 合并 是 非常 困难 的 。 并 且 无 法 保证 每 个 团队 成 员 都 能 
进行 合并 ， 偷偷 地 直接 将 他 人 的 修改 覆盖 而 不 进行 合并 也 完全 有 可 能 不 
饭 发 现 。 

Subversion 和 Git 等 比较 新 的 版 本 管理 系统 的 设计 思想 是 : 原则 上 
不 对 文件 加 锁 ， 并 对 多 人 的 修改 进行 合并 处 理 ， 有 冲突 时 会 明示 并 让 冲 
突 发 生 。 

另 一 方面 , 以 前 的 VSS ( Visual Source Safe ) “等 版 本 管理 系统 的 设 
计 思 想 则 是 对 文件 加 锁 来 避免 冲突 的 发 生 。 

如 果 团 队 中 有 工程 师 是 在 使 用 VSS 等 基于 锁 的 版 本 管理 系统 的 开发 
现场 成 长 起 来 的 话 ， 可 能 会 因为 不 习惯 Subversion 和 Git 这 类 基于 合并 
的 管理 系统 的 思维 方式 ， 而 对 于 发 生 冲 突 时 一 定 要 消除 冲突 无 法 理解 。 
也 可 能 是 因为 开发 人 员 和 觉得 无 视 冲突 ， 强行 窗 盖 原 有 代码 不 会 有 什么 问 
题 ， 结 采 造 成 了 类 似 这 种 现象 的 发 生 。 

关于 使 用 版 本 管理 系统 来 消除 冲突 的 方法 ， 以 及 基于 合并 的 版 本 管 
理 系统 更 为 优秀 的 原因 等 ， 将 在 第 3 章 中 进行 讲解 。 

在 类 似 于 这 次 例子 的 情况 中 ， 如 采写 好 测试 用 例 并 用 CI 进行 测试 
的 话 ， 应 该 就 能 及 早 发 现 问题 。CI 相关 的 内 容 将 在 第 5 章 进 行 讲解 。 





























2.5.3 ”问题 7 : 无 法 自信 地 进行 代码 重 构 








几 处 修改 bug 的 代码 因 被 其 他 组 员 的 提交 所 窗 坟 而 消失 了 。 通 过 人 姐 
碍 提交 记录 终于 把 问题 摘 清 楚 了 ， 但 怎么 修改 才 是 最 优雅 的 ， 成 了 件 烦 
心 的 事情 。 

在 多 人 进行 的 开发 中 ， 修 改 的 地 方 发 生 冲 罕 是 因为 在 同一 处 地 方 基 





@ 微软 在 2012 年 之 前 提供 支持 的 版 本 管理 系统 。 现 在 提供 的 是 其 后 续 产 品 Team 


Foundation Server。 
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于 不 同 的 目的 添加 了 不 同 的 代码 。 这 意味 着 需要 以 某 种 形式 来 重新 考虑 
代码 的 构造 ， 也 就 是 说 需要 进行 重 构 。 
根据 维基 百科 ， 重 构 的 定义 是 这 样 的 。 





重 构 ( refactoring ) 是 指 计算 机 编程 中 ， 在 不 影响 输出 结果 的 
前 提 下 对 代码 内 部 的 构造 进行 整理 。 





正如 上 面 所 描述 的 “不 影响 输出 结果 ”， 重 构 必须 保证 程序 的 对 外 
输出 保持 不 变 。 也 就 是 说 需要 定义 出 该 程序 中 什么 是 正确 的 。 

方法 之 一 就 是 准备 好 规格 说 明 等 资料 。 这 个 方法 的 确 可 以 证 明 “ 正 
确 性 ”， 但 每 次 都 要 手动 确认 重 构 后 程序 的 动作 是 否 符合 规格 要 求 ， 实 
在 太 耗 费时 间 了 。 

一 想到 又 费时 又 麻烦 ， 心 理 上 对 于 重 构 的 抵触 情绪 就 愈 发 高 涨 ， 不 
愿意 动手 去 做 。 在 一 些 开发 现场 ,“ 不 要 动 已 经 在 运行 的 程序 ” 像 这 样 
明令 禁止 重 构 的 情况 也 是 存在 的 。 

为 了 消除 这 样 的 抵触 情绪 ， 能 够 自信 地 进行 重 构 ， 测 试 代码 的 编写 
就 显得 尤为 重要 。 如 前 所 述 ， 重 构 是 “在 不 影响 输出 结果 的 前 提 下 对 代 
码 内 部 的 构造 进行 整理 ”， 因 此 只 要 编写 的 测试 代码 可 以 保证 输出 结 
不 发 生变 化 就 可 以 了 “。 将 测试 代码 做 成 只 调用 一 个 命令 就 能 执行 的 形 
式 ， 这 样 就 可 以 简单 地 反复 进行 测试 ， 从 而 在 任何 时 间 都 可 以 迅速 地 对 
程序 的 正确 性 进行 确认 。 只 有 有 了 这 样 的 测试 环境 ， 才 能 重新 着 手 重 构 
帮 民 1 

能 够 为 编写 测试 代码 提供 方便 的 测试 框架 有 很 多 。 测 试 框架 以 及 测 
试 代码 的 写法 将 在 第 5 章 进行 讲解 。 

邻 令 依 

成 功 编写 测试 代码 后 ， 心 理 上 对 于 重 构 的 抵触 情绪 就 能 大 幅 减 少 。 
在 进行 代码 重 构 后 并 提交 到 版 本 管理 系统 的 代码 库 之 前 ， 调 用 一 条 命令 
执行 测试 ， 这 样 就 能 对 重 构 内 容 的 正确 性 进行 确认 。 所 以 即使 重 构 中 发 
































(DD 最 好 是 对 对 象 类 中 的 public 方法 ， 即 公开 的 API 编写 单元 测试 。 但 是 由 于 类 的 分 
割 不 合理 、 数 据 库 或 用 户 界 面 和 系统 的 耦合 过 于 紧密 等 原因 ， 无 法 编写 单元 测试 
的 情况 也 时 有 发 生 。 在 这 样 的 情况 下 ， 可 以 对 系统 最 外 侧 的 API ( 一般 情 况 下 是 
用 户 界面 ) 编写 测试 代码 。 相 关内 容 将 在 第 7 章 中 进行 讲解 。 
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生 了 错误 ， 也 能 在 提交 之 前 及 时 发 现 。 

进一步 导入 CI， 让 测试 代码 能 够 一 直 目 动 执 行 。 对 程序 正确 性 进行 
测试 的 机 会 越 多 ， 越 能 够 安心 地 进行 重 构 。 即 使 在 本 地 环境 中 通过 测 
试 ， 和 其 他 开发 人 员 修 改 的 代码 合并 后 仍 有 可 能 测试 失败 。 并 且 开 发 人 
员 毕 苋 也 是 人 人， 所 以 在 提交 之 前 忘记 执行 测试 也 是 有 可 能 的 。 导 入 CI 
的 话 ， 因 为 CI 服务 器 会 目 动 执行 测试 ， 所 以 束 能 够 及 时 发 现 问 题 。CI 
服务 需 可 以 每 天 定时 执行 测试 ， 也 可 以 每 当 辐 版 本 管理 系统 的 代码 库 进 
行 提 交 时 执行 测试 ， 根 据 配置 可 以 在 各 种 时 间 点 执行 测试 并 发 现 问题 。 
通过 编写 测试 代码 以 及 导入 CI， 终于 可 以 自信 地 进行 代码 重 构 了 ， 产 品 
的 品质 也 自然 而 然 地 有 了 提高 。 

相反 ， 婚 不 写 测 试 代码 ， 也 不 进行 CI， 并 且 也 不 进行 重 构 ， 这 样 持 
续 维 护 的 代码 就 会 成 为 巨大 的 负担 ， 直 至 阻碍 事业 的 发 展 。 这 样 的 代码 
在 《修改 代码 的 艺术 》 中 被 定义 为 Legacy code。 

不 编写 测试 代码 导致 产生 大 量 的 legacy code， 因 此 软件 的 品质 完全 
无 法 提高 。 确 认 “ 正 确 性 ”的 手段 只 有 手动 和 用 眼睛 看 ， 在 这 样 的 情况 
下 ,“ 正 确 性 ”的 确认 就 会 白白 浪费 大 量 时 间 , 执行 回归 测试 “就 更 不 现 
实 了 。 越 没 时 间 越 不 写 测试 代码 ， 从 而 产生 越 来 越 多 的 legacy code， 这 
样 便 陷 人 了 恶性 循环 之 中 。 

这 样 的 恶性 循环 持续 几 年 后 便 会 陷 人 绝境 ， 不 要 次 添加 新 功能 
连 bug 修正 都 忙 不 过 来 ， 最 终 只 能 被 时 代 所 淘汰 。 这 样 的 软件 产品 并 不 
在 少数 。 

关于 重 构 所 必需 的 测试 代码 的 写法 ， 以 及 持续 地 自动 进行 测试 的 CI 
实践 ， 这 些 将 在 第 5 章 中 进行 讲解 。 


























2.5.4 ”问题 8 : 不 知道 bug 的 修正 日 期 ， 也 不 能 追踪 退化 





在 刚才 的 例子 中 ， 发 生 了 以 前 修正 的 bug 再 度 出 现 ( 发生 了 退化 ) 
的 情况 。 不 知道 bug 是 什么 时 候 发 生 的 、 是 怎样 的 bug、 在 哪 次 提交 中 








@ 《修改 代码 的 艺术 》( 美 ) Michael C. Feathers 著 ， 候 伯 和 被 译 ， 机 械 工 业 出 版 社 
2014 年 出 版 。 一 译 者 注 
@) 该 测试 的 目的 是 检查 程序 的 修改 所 带 来 的 影响 。 上 有 具体 请 参考 第 7 章 。 
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被 修正 ， 这 样 的 事情 在 已 经 运营 较 长 时 间 的 系统 中 可 能 是 比较 篆 见 的 。 
如 果 仅 用 邮件 或 口头 交流 故障 和 bug， 没 有 在 团队 成 员 之 间 共 享 信息 ， 
就 容易 发 生 这 样 的 事情 。 为 此 ， 首 先 使 用 缺陷 管理 系统 将 问题 从 发 生 到 
解决 的 所 有 过 程 记 录 下 来 是 非常 重要 的 。 关 于 缺陷 管理 系统 ， 将 在 第 4 
草 进 行 讲 解 。 

然后 ， 通 过 使 版 本 管理 系统 和 缺陷 管理 系统 进行 交互 ， 就 能 关联 代 
人 码 的 修改 记录 和 问题 票 ， 并 记录 下 来 。 这 样 就 可 以 从 间 题 票 妃 踪 到 代码 
的 修改 记录 ， 找 出 bug 是 何 时 修正 的 、 谁 修正 的 、 如 何 修正 的 这 些 信 
垦 。 反 过 来 也 可 以 从 版 本 省 理 系 统 上 的 修改 记录 追踪 到 描述 问题 的 bug 
票 。 如 此 一 来 ， 就 既 可 以 从 间 题 票 追 踊 代 码 ， 查 看 代码 被 做 了 怎样 的 修 
改 ， 即 过 去 的 问题 票 的 处 理 结果 ， 又 可 以 从 代码 的 提交 记录 追 溯 问题 
票 ， 查 看 问题 的 原因 ， 使 双 癌 追踪 成 为 了 可 能 。 

版 本 管理 系统 和 缺陷 管理 系统 高 效 进行 交互 的 方法 将 在 第 4 章 中 进 
行 讲解 。 只 需 稍微 花 一 些 功夫 ， 问 题 的 可 追踪 性 “就 会 有 所 提升 ， 这 是 
非常 有 效 的 实践 。 

并 且 ，CI 和 缺陷 管理 系统 以 及 版 本 管理 系统 这 三 者 之 间 的 交互 也 是 
非常 重要 的 。 这 样 一 来 ， 某 个 问题 是 在 什么 时 候 被 什么 人 怎样 修改 的 ， 
以 及 修改 结果 是 否 通 过 了 测试 、 是 否 反 映 到 了 staging 环境 、 是 否 发 布 
到 了 正式 环境 等 ， 整 个 过 程 就 都 可 以 进行 妃 踪 。CI 和 缺陷 管理 系统 以 及 
版 本 省 理 系 统 的 交互 ， 可 以 胎 不 耸 张 地 说 是 现代 系统 开发 中 的 三 种 神 
希 。 特 别 是 在 实行 敏捷 开发 的 情况 下 ， 这 些 是 最 基础 的 实践 项 目 。 关 于 
这 部 分 将 在 第 $ 草 中 进行 讲解 。 

更 进一步 ， 如 果 和 部 署 目 动 化 工具 相关 联 ， 那 么 到 部 署 、 发 布 为 
止 就 都 可 以 进行 统一 的 管理 。 近 年 来 ， 一 些 最 先进 的 开发 现场 已 经 在 
尝试 目 动 化 部 署 。 包 括 目 动 化 部 署 在 内 的 管理 相关 的 内 容 将 在 第 6 章 
进行 讲解 。 
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2.5.5 问题 9 : 没有 灵活 使 用 分 支 和 标签 


这 里 举 的 是 修正 结束 后 回 到 新 功能 开发 时 ， 差 点 忘记 合并 的 例子 。 
问题 3 中 已 经 提 到 过 ， 这 是 因为 没有 合理 使 用 版 本 管理 系统 的 分 文 和 标 
签 功能 而 产生 的 问题 。 关 于 使 用 版 本 管理 系统 有 效 地 并 行 开发 多 个 任务 
的 方法 将 在 第 3 章 中 进行 讲解 。 





2.5.6 ”问题 10 : 在 测试 环境 、 正 式 环 境 上 无 法 运 和 


J 


eeeoeeeoeeoeoeee 





这 应 该 是 开发 现场 向 有 的 事 ， 以 “在 目 己 的 本 地 环境 上 能 正 滑 运行 ” 
为 由 ， 而 无 视 staging 环境 或 正式 环境 中 发 生 的 问题 ， 这 样 的 开发 人 员 有 时 
还 是 会 过 到 的 。 和 这 样 的 开发 人 员 是 无 法 进行 沟通 的 。 而 将 在 开发 环境 中 运 
行 的 内 容 在 测试 环境 中 运行 起 来 要 费 一 番 功 大， 将 在 staging 环境 中 运行 的 内 
容 在 正式 环境 中 运行 起 来 也 要 费 一 番 功 夫 ， 这 样 的 话题 倒 也 经 常 昕 说 。 

根据 环境 的 不 同 ， 程 序 运行 的 动作 发 生变 化 的 问题 通常 称 为 “环境 
依赖 问题 ”。 由 于 环境 依赖 而 产生 的 问题 究竟 是 怎样 的 呢 ? 以 下 是 一 些 
常见 的 情况 : 











e 由 于 数据 库 模式 的 差异 而 产生 的 问题 

e 没有 安装 程序 所 依赖 的 库 而 产生 的 问题 

e httpd 或 memcached 等 各 种 中 间 件 由 于 环境 不 同 而 配置 发 生变 
化 的 问题 











数据 库 模式 差异 的 管理 问题 ,已 经 在 问题 4 中 讨论 过 ， 具 体 将 第 3 
章 中 进行 讲解 。 程 序 依 赖 库 的 问题 也 将 在 第 3 章 的 依赖 关系 的 管理 这 一 
小 节 中 进行 讲解 。 

中 间 件 等 配置 的 问题 ， 必 然 会 因为 环境 的 不 同 而 产生 差异 ， 管 理 
起 来 的 确 是 比较 困难 的 。 在 第 3 章 和 第 6 章 中 将 介绍 管理 相关 的 一 些 
小 技巧 。 

为 了 实现 高 效 、 高 品质 的 开发 ， 这 些 问 题 不 能 用 “环境 依赖 ”一 语 
市 过 ， 而 应 该 试 着 去 摸索 解决 方案 。 作 为 全 世界 开发 人 员 努 力 的 结 
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下 


现在 已 经 出 现 了 帮助 解决 这 类 问题 的 工具 。 这 部 分 内 容 将 在 第 6 章 中 进 
行 讲解 。 


2.5.7 ”问题 11 : 发 布 太 复杂 ， 以 至 于 需要 发 布 手 册 


这 个 问题 和 问题 10 也 是 相通 的 。 无 论 哪 里 的 现场 ， 回 正式 环境 进 
行 发 布 都 是 件 复杂 并 且 伴 有 紧张 感 的 事情 。 数 百 行 的 发 布 手册 由 多 人 确 
认 两 三 遍 ， 即 使 如 此 谨 屠 地 进行 发 布 ， 大 多 数 情 况 下 也 都 不 会 很 顺利 。 
经 历 了 各 种 困难 终于 让 程序 运行 了 起 来 ， 如 有 果 能 不 出 故障 、 持 续 地 运行 
的 话 ， 那 就 是 上 天 保佑 了 。 这 难道 不 是 开发 现场 的 实际 情况 吗 ? 

并 且 在 大 多 数 情况 下 ， 大 家 往往 会 忘记 将 只 对 正式 环境 进行 的 作业 
提交 到 代码 库 ， 或 者 忘记 反映 到 发 布 手册 上 。 如 果 还 不 得 不 去 解决 其 他 
故障 的 话 ， 那 就 更 不 用 说 了 。 再 加 上 还 要 提交 故障 说 明报 告 、 问 发 布 手 
册 添 加 数量 庞大 的 确认 项 目 ， 或 者 确认 这 些 项 目的 人 数 大 大 增加 ， 这 样 
一 来 就 会 使 业务 更 加 复杂 。 

男 一 方面 ， 多 数 热 门 的 Web 服务 都 以 惊人 的 势头 一 边 修正 bug 一 边 
开发 看 新 功能 。 例 如 社交 编程 服务 ， 也 就 是 Git 的 托管 服务 一 一 大 名 易 
易 的 GitHub 在 1 天 之 内 要 进行 100 次 以 上 的 发 布 “。 

怎样 才能 做 到 以 这 样 司 人 的 速度 一 个 接 一 个 地 进行 发 布 呢 ? 至 少 可 
以 知道 肯定 不 是 用 发 布 手册 人 工 介 入 进行 的 。 

就 算 GitHub 这 样 惊人 的 发 布 频率 属于 例外 情况 ,但 如 果 部 署 和 发 
布 能 够 通过 自动 化 简化 一 些 的 话 ， 不 仪 能够 减少 作业 中 的 错误 ， 包括 用 
户 和 开发 人 员 在 内 ， 大 家 都 会 对 此 喜闻乐见 吧 。 

为 了 实现 上 述 内 容 ， 需 要 解决 环境 依赖 的 问题 ， 还 需要 实现 自动 化 
测试 和 目 动 化 部 署 。 换 言 之 就 是 持续 地 维持 “随时 都 能 发 布 ”的 状态 是 
非常 重要 的 。 

这 样 的 想法 称 为 持续 交付 (CD )。CD 是 有 一 定 难度 的 实践 ， 但 一 
日 实现 ,团队 的 敏捷 开发 效率 就 会 有 飞跃 般 的 提升 。 这 部 分 内 容 将 在 第 
6 草 进 行 讲解 。 


eeeeeeeeeeee 


















































(D https://github.com/ 
©) Deploying at GitHub (https://github.cony/blog/1241-deploying-at-github ) 
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2.6 什么 是 理想 的 项 目 


前 几 节 中 我 们 回顾 了 死亡 行军 项 目的 现状 以 及 从 中 看 出 的 具体 问 
题 。 解 决 这 些 问 题 要 正确 执行 团队 开发 的 流程 。 

而 正确 执行 开发 流程 则 需要 正确 理解 所 使 用 的 工具 的 机 制 ， 合 理 掌 
握 工 具 的 使 用 方法 。 当 然 不 是 用 了 工具 就 能 解决 所 有 的 问题 ， 其 他 还 有 
团队 成 员 的 教育 、 思 想 准备 等 各 种 各 样 的 方法 论 。 但 最 重要 的 还 是 对 工 
具 的 理解 以 及 合理 运用 ， 由 此 也 造成 了 软件 开发 的 速度 和 质量 的 差异 。 

从 第 3 章 开 始 我 们 将 对 这 些 工 具 进行 介绍 ， 并 详细 讲解 这 些 工 具 的 
使 用 方法 、 为 什么 需要 这 蒜 工 具 以 及 应 该 注意 哪些 地 方 。 

作为 本 音 的 总 结 ， 我 们 来 看 一 下 理想 的 项 目 开 发 流程 (图 2.7 )。 


图 2.7 理想 的 开发 流程 示例 


























staging 环境 


缺陷 管理 


反映 测试 
可 结果 






系统 
反映 提交 | ”| 对 提交 、 测 试 、 
记录 部 团 的 状况 进行 











图 2.7 看 起 来 有 点 复杂 ， 但 其 实 很 简单 ， 也 就 是 说 ， 只 要 根据 本 章 
中 发 生 的 事情 以 及 从 中 反映 出 来 的 问题 逆 回 为 之 就 可 以 了 。 
具体 可 以 总 结 为 以 下 几 点 。 
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2.6.1 使 用 缺陷 管理 系统 对 课题 等 进行 统筹 管理 


使 用 缺陷 管理 系统 而 非 邮件 对 课题 、 要 做 的 任务 、 发 生 的 故障 等 进 
行 统筹 管理 。 其 中 ， 对 优先 度 和 重要 度 进行 明确 地 管理 ， 以 及 清楚 地 掌 
握 每 一 个 bug 票 的 状态 ， 这 些 是 非常 重要 的 。 

易于 检索 ， 能 很 快 地 找到 想 找 的 信息 ， 能 检索 到 过 去 的 bug 票 以 及 
与 其 相关 的 处 理 结果 ， 这 些 也 是 很 重要 的 。bug 票 的 处 理 结果 是 版 本 管 
理 中 的 提交 记录 、 是 CI 系统 的 测试 结果 ， 需 要 确保 能 够 检索 到 现在 被 
部 署 到 了 哪个 环境 中 。 另 外 ， 不 仅仅 要 向 开发 团队 的 全 体 成 员 ， 还 要 向 
项 目的 所 有 利益 相关 者 “共享 缺陷 管理 系统 中 统筹 管理 的 信息 ， 这 点 也 
是 很 重要 的 。 

















2.6.2 ”尽量 使 用 版 本 管理 系统 


首先 要 正确 使 用 版 本 管理 系统 ， 避 人 免 无 意 中 将 他 人 的 修正 窗 益 。 其 
次 要 合理 地 管理 分 文 ， 明 确 正式 环境 中 使 用 的 是 哪个 分 文 ， 最 近 修 正 
bug 所 用 的 是 哪个 分 文 ， 新 功能 开发 使 用 的 是 哪个 分 文 ， 这 点 很 重要 。 
这 样 束 可 以 并 行 推进 多 个 开发 任务 。 

男 外 ， 通 过 合理 地 管理 标签 ， 将 菏 个 时 间 点 发 布 状 态 的 截面 保存 下 
来 ， 这 样 无 论 多 久之 前 的 状态 都 能 够 进行 回 深 ， 这 点 是 很 重要 的 。 还 
有 ， 用 版 本 管理 系统 来 统筹 数据 库 的 变更 管理 和 环境 相关 的 配置 文件 的 
管理 等 也 是 很 重要 的 。 


seeeeeeseeeseeeeeeseeeseeeeeseeeseeeeseeeeseeeseeeeeeseeeeeeeeeeseeseeeseeeeeeeeeeee 

















2.6.3 准备 可 以 反复 验证 的 Cl 系统 


准备 好 CI 系统， 时常 将 所 有 的 资源 集中 到 1 处 ， 并 通过 build 确 
认 是 否 可 以 正常 合并 ， 以 及 确认 单元 测试 是 否 总 能 通过 ， 这 些 都 是 很 
重要 的 。 这 样 就 能 立即 发 现 提 交 遗 漏 、 修 正 错误 等 问题 ， 从 而 提高 软 
件 质量 。 


eeeeeeeeeseeeeeseeeseeeeeeeseeeseeeeseeeeeeseeeseeeeeeeeeeeeeee 








四， 不 一 定 隶 属于 开发 团队 ， 但 是 会 受到 项 目 结果 影响 的 利害 关系 人 。 
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并 且 还 需要 恰当 地 编写 测试 代码 和 build 脚本。 这 里 的 “恰当 ”是 
和 无论 重复 执行 多 少 次 ， 都 不 会 因为 依赖 某 些 状态 而 改变 执行 的 结果 。 
例如 数据 库 状 态 、 环 境 变量 、 中 间 件 的 配置 等 都 适用 于 此 。 将 这 些 内 容 
总 结 在 一 起 写成 脚本 ， 这 样 原本 复杂 的 数据 库 构 建 和 环境 构建 就 能 简单 
地 进行 了 ， 执 行 测试 的 难度 也 会 相应 下 降 。 











2.6.4 “将 环境 的 影响 控制 在 最 小 限度 ， 并 随时 可 以 发 布 


管理 因 环境 不 同 而 产生 的 差异 的 确 是 比较 困难 的 ,但 现在 有 了 实用 
的 工具 。 如 前 所 述 ， 合理 使 用 脚本 和 工具 ， 对 数据 库 的 变更 以 及 各 个 中 
间 件 等 因 环境 而 产生 差异 的 内 容 进行 版 本 管理 。 这 样 只 要 准备 好 可 以 重 
复 执行 的 环境 构建 、 发 布 以 及 动作 确认 的 测试 等， 应 该 就 可 以 随时 发 布 
最 新 的 程序 了 。 


ee 








2.6.5 ”保留 所 有 记录 以 便 日 后 追踪 


seeeeeeseeeeseeseeeseeseeseeeeseseeeeseeseeeseseeeeeseeseeeeseeeeeeeeseeeeeee 





之 前 已 经 捉 到 了 很 多 次 ， 对 至 今 为 止 所 有 的 操作 进行 管理 、 记 录 ， 
并 做 到 可 仍 踩 是 非常 重要 的 。 包 括 什么 时 候 什 么 人 对 程序 进行 了 怎样 的 
修改 、 原 来 发 生 了 怎样 的 问题 、 是 否 通过 了 测试 、 是 否 进行 了 发 布 等 所 
有 信息 。 

并 且 对 上 述 信息 进行 简洁 、 方 便 的 管理 也 是 很 重要 的 。 如 采用 纸 或 
Excel 的 工作 短 ， 无 论 负 责 管理 的 人 员 多 么 努力 ， 也 无 法 提高 开发 速度 。 
所 有 事情 都 应 该 实现 目 动 化 的 简洁 管理 。 
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2.7 ”本 章 总 结 





怎么 样 ? 实现 了 2.6 市 中 列举 的 关键 点 的 项 目 应 该 可 以 称 为 理想 的 
项 目 了 吧 ? 这 和 案例 分 析 中 死亡 行军 的 项 目 有 着 天 壤 之 别 。 可 是 ， 怎 么 
才能 做 出 这 种 理想 的 项 目 呢 ? 

关于 团队 开发 过 程 中 应 该 采取 的 措施 ， 以 及 各 种 必要 的 工具 的 使 用 
方法 ,我 们 将 从 第 3 章 开 始 进行 详细 讲解 。 

但 是 请 不 要 忘记 ， 熟练 使 用 工具 的 日 的 是 实现 项 目 中 提出 的 目标 ， 
也 就 是 使 顾客 的 价值 最 大 化 。 

为 了 迅速 并 且 准 确 地 实现 项 目 中 提出 的 目标 ， 应 尽 可 能 地 把 可 以 
目 动 化 的 工作 交 给 工具 进行 ,不 要 在 与 用 户 价 值 无 关 的 作业 和 没有 必 
要 烦恼 的 事情 上 浪费 筋 动力 ， 这 是 非 第 重要 的 。 这 样 ， 项 目的 开发 人 
员 才 能 将 注意 力 集中 在 本 来 应 该 天 注 的 地 方 ， 例 如 项 目的 目标 是 否 能 
够 达成 、 现 在 所 做 的 是 否 俩 离 正 确 作 法 等 ， 并 最 终 交 出 完美 的 答卷 ， 
这 才 是 重要 的 。 

接 下 来 ， 就 让 我 们 来 学 习 全 世界 工程 师 们 费 尽 心机 所 开发 出 来 的 实 
践 方法 和 工具 吧 。 
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3.1 版 本 管理 系统 


3.1.1 什么 是 版 本 管理 系统 


合理 、 有 效 地 利用 版 本 管理 系统 是 顺利 进行 团队 开发 必 不 可 少 的 、 
最 基础 的 工作 。 是 否 正确 理解 了 版 本 管理 系统 的 概念 及 其 意义 将 下 接 左 
右 团 队 所 发 布 的 产品 的 质量 中 最 基本 的 部 分 。 

究竟 什么 是 版 本 管理 系统 ?” 版 本 管理 系统 是 将 什么 时 候 、 谁 、 对 
文件 做 了 怎样 的 修改 这 样 的 信息 以 版 本 的 形式 保存 并 进行 管理 的 系统 。 
这 里 提 到 的 文件 当然 包括 代码 ,但 不 是 说 版 本 管理 系统 只 能 管理 代码 
的 版 本 。 

新 建 表 或 导入 数据 用 的 SQL 文件 、 构 贷 中 间 件 用 的 配置 文件 ， 其 
至 是 应 用 程序 的 说 明 手 册 等 ， 只 要 是 文件 ， 都 可 以 用 版 本 管理 系统 进行 
管理 。 


下 面 我 们 来 看 一 下 使 用 版 本 管理 系统 所 市 来 的 便利 之 处 。 




















3.1.2 ”为 什么 使 用 版 本 管理 系统 能 市 来 便利 


使 用 版 本 管理 系统 的 优点 如 下 所 示 。 


能 够 保留 修改 内 容 这 一 最 基本 的 记录 

能 够 方便 地 查看 版 本 之 间 的 差异 

能 够 防止 第 误 地 窗 盖 别人 修改 的 代码 

能 够 还 原 到 任意 时 间 点 的 状态 

能 够 生成 多 个 派生 ( 分 支 和 标签 )， 保 留 当 时 项 目 状 态 的 截面 
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e@…… 能 够 保留 修改 内 容 这 一 最 基本 的 记录 


什么 时 候 、 谁 、 对 文件 做 了 怎样 的 修改 这 些 信息 ， 虽 说 是 最 基本 
的 ,但 将 其 作为 记录 保留 下 来 也 是 非常 重要 的 。 在 发 生 问题 时 ， 退 踪 
录 ( 提交 ) 能 够 帮助 查 明 问 题 的 原因 。 

里 然 写 在 纸 上 或 者 使 用 Excel 表格 来 人 工 进行 管理 也 能 达到 同样 的 
效果 ， 但 这 样 团队 需要 的 人 数 束 会 增加 。 随 看 处 理 的 文件 种 类 的 增加 ， 
很 快 这 个 方法 束 会 变 得 不 那么 现实 了 。 

最 近 使 用 上 述 管 理 方法 的 项 目 已 经 越 来 越 少见 了 ,但 是 在 一 些 工程 
师 较 少 的 网 站 制作 现场 等 ， 还 是 会 有 一 些 人 工 管理 的 地 方 。 如 果 你 正好 
在 这 样 的 现场 ， 就 算 只 是 为 了 简化 记录 操作 ， 也 可 以 考虑 试 春 使 用 版 本 
管理 系统 。 



































e@…… 能够 方便 地 查看 版 本 之 间 的 差异 


使 用 svn diff 或 git diff 这 样 的 命令 就 能 方便 地 确认 各 个 版 
本 之 间 的 差异 “。 可 以 输入 命令 ， 从 命令 行进 行 确认 。 还 可 以 通过 
TortoiseSVN”、TortoiseGit”、SourceTree "这样 的 GUI ( Graphical User 
Interface ) 工具 进行 可 视 化 确认 。 除 此 之 外 ， 还 可 以 使 用 Trac 或 GitHub 
这 样 的 基于 Web 的 代码 库 浏 览 需 进行 确认 。 

能 够 简单 地 确认 版 本 间 的 差异 是 版 本 管理 系统 的 优秀 特征 之 一 。 


@…… 能 够 防止 缘 误 地 覆盖 他 人 修改 的 代码 


说 起 版 本 管理 系统 和 简单 的 表格 管理 的 区 别 ， 首 先 想到 的 就 是 该 功 
能 。 版 本 管理 系统 将 文件 的 修改 记录 作为 数据 库 进行 管理 ， 所 以 能 够 防 
止 多 人 在 同一 时 间 修 改 同 一 文件 的 同一 处 。 











(D 请 注意 能 够 简单 地 确认 差异 这 一 点 原则 上 仅 适用 于 文本 文件 ， 图 片 这 样 的 二 进 制 
文件 则 无 法 简单 地 确认 差异 。 虽 然 从 技术 上 来 说 是 能 够 找 出 二 进 制 文件 的 差异 
的 ， 但 是 这 样 的 差异 不 是 人 类 能 够 理解 的 ， 只 是 二 进 制 数 据 之 间 的 差异 。 
http://tortoisesvn.net/ 


https://code.google.com/p/tortoisegit/ 


外 的 的 


http://www.sourcetreeapp.com/ 
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第 2 草 列 举 了 错误 地 把 他 人 的 修改 履 盖 的 例子 ， 如 果 合 理 地 使 用 版 
本 管理 系统 ， 驶 不 会 发 生 这 样 的 事情 。 

由 多 人 修改 而 造成 的 冲突 也 称 为 conflict 或 collision 7。 为 了 解决 冲突 
的 问题 ， 版 本 管理 系统 大 致 提供 了 两 类 机 制 ， 分 别 是 “ 锁 -修改 -解锁 
模式 ”( 以 下 称 为 锁 模式 ) 和 “复制 -修改 -合并 模式 ”( 以 下 称 为 合并 
模式 )。 

锁 模 式 的 做 法 是 : 在 某 人 编辑 文件 期 间 ， 将 文件 锁 住 ， 不 允许 其 他 
人 对 此 文件 进行 编辑 。 过 去 的 商用 版 本 管理 系统 主要 采用 这 种 方式 。 这 
种 方式 的 特点 是 简单 ， 对 任何 人 来 说 都 是 易于 理解 、 易 于 操作 。 但 是 缺 
点 在 于 无 法 多 人 同时 进行 并 行 开 发 ， 难 以 提高 开发 速度 。 

合并 模式 不 会 对 文件 加 锁 。 开 发 者 下 载 代码 的 备份 进行 编辑 ， 然 
后 再 提交 到 代码 库 。 提 交 时 确认 差异 〈diff )， 如 采 存 在 差异 ， 要 先 对 
差异 进行 合并 ， 然 后 再 提交 。 近 几 年 的 版 本 管理 系统 基本 上 都 采用 这 
种 方 起 

CVS ( Concurrent Versions System )、Subversion 、Git 这 些 有 名 的 版 
本 管理 系统 都 属于 合并 模式 。 该 模式 的 优势 在 于 不 对 文件 加 锁 ， 多 人 可 
以 同时 获取 最 新 的 代码 而 不 必 等待 他 人 的 作业 ， 能 够 并 行 地 推进 开发 。 
和 其 他 团队 成 员 的 修改 产生 冲突 时 ， 可 以 通过 合并 来 消除 冲突 。 

邻 令 仿 

无 论 是 锁 模 式 还 是 合并 模式 ,合理 使 用 版 本 管理 系统 都 能 够 防止 无 

意识 地 乾 善 他 人 修改 的 代码 。 




















一 专栏 ” 锁 模式 和 合并 模式 
如 上 所 述 ， 版 本 管理 系统 解决 冲突 的 方式 大 致 可 分 为 两 种 ， 即 

锁 模 式 和 合并 模式 。 
VSS ( Visual Source Safe ) 和 Peroforce、PVCS2 这 样 的 专 有 商 
用 版 本 管理 系统 多 采用 锁 模式 ~“。CVS、Subversion、Git、mercurial 








JJ 该 词 多 用 来 指 网 络 数据 的 冲突 ， 所 以 用 来 指 代 码 修改 的 冲突 可 能 并 不 是 那么 的 合 
适 ， 但 也 有 不 少 开发 现场 是 这 么 称呼 的 。 

@ 专 有 软件 (proprietary software )， 和 它 相对 的 是 自由 软件 。 译 者 注 

B83) 这些 产品 现在 也 已 经 具备 了 包括 合并 模式 在 内 的 各 种 先进 的 功能 。 
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等 OSS ( Open Source Software， 开 源 软 件 ) 的 版 本 管理 系统 多 采 
用 合并 模式 。 

两 种 方法 都 有 各 自 的 长 处 和 短处 。 近 年 来 使 用 Subversion 和 
Git 的 开发 现场 较 多 ， 合 并 模式 也 逐渐 成 为 主流 。 但 在 大 约 10 年 之 
前 ， 锁 模式 的 商用 版 本 管理 系统 一 直 都 占据 着 主流 位 置 。 

当时 开源 软件 还 没有 像 今天 这 样 被 大 量 用 于 开发 现场 ， 因 此 比 
较 多 的 是 采用 商用 的 版 本 管理 系统 。 一 些 由 那个 时 代 的 工程 师 主 
管 的 开发 现场 ， 至 今 好 像 依 然 在 使 用 VSS 这 样 的 锁 模 式 的 版 本 管理 
系统 。 

有 的 开发 现场 虽然 使 用 了 Subversion 或 Git， 但 思维 方式 还 是 
基于 锁 模式 ， 因 此 还 是 无 法 合理 运用 版 本 管理 系统 。 

饥 模 陈 的 情况 下 ， 在 某 人 编辑 文件 期 间 ， 文 件 将 被 锁 住 ， 所 以 
理论 上 不 会 发 生 冲 突 。 但 另 一 方面 ， 多 人 同时 并 行 编辑 同一 文件 原 
则 上 也 变 得 不 可 能 ( 图 3.a )， 这 样 就 大 大 影响 了 开发 速度 。 如 果 有 
人 将 文件 锁 住 后 去 休假 了 ， 那 么 开发 就 无 法 进行 下 去 了 “。 

图 3.a ” 锁 模 式 下 无 法 同时 并 行 地 进行 编辑 











- 
中 央 代 码 库 中 央 代码 库 

在 太郎 锁 住 文件 A 进行 编辑 期 间 ， ”在 太郎 完成 编辑 并 解锁 后 ， 花 子 

花子 无 法 再 对 文件 A 加 锁 。 在 太郎 ”才能 将 文件 A 签 出 。 也 就 是 说 

完成 编辑 并 解锁 之 前 ， 花 子 只 能 等 待 。 ”多 个 人 不 能 同时 编辑 同一 个 文件 








与 之 相对 ， 合 并 模式 不 需要 对 文件 加 锁 ， 所 以 同一 文件 可 以 同 


@D 实际 上 版 本 管理 系统 一 般 都 有 强制 解除 锁 的 功能 ， 但 这 需要 管理 员 权限 ， 操 作 起 
来 也 比较 麻烦 。 
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时 由 多 人 并 行 地 进行 开发 ( 图 3.b )。 提 交 时 会 提醒 你 确认 差异 并 进 
行 合 并 ， 与 他 人 编辑 的 地 方 发 生 重合 时 也 会 检测 出 冲突 ( 图 3.c )。 


图 3.b ”合并 模式 下 能 够 同时 并 行 地 进行 编辑 





中 央 代码 库 中 央 代码 库 
3 3 








因为 没有 对 文件 加 锁 ， 所 以 太 即 先进 行 了 提交 ， 所 以 花子 的 提 

太郎 和 花子 两 人 可 以 同时 签 交 不 是 最 新 的 ， 不 能 直接 提交 。 这 

出 文件 A 时 会 提醒 花子 合并 太朗 编辑 的 内 容 
使 文件 成 为 最 新 状态 








图 3.c ”通过 更 新 ( update ) 来 统一 本 地 机 器 上 的 环境 


更 新 并 合并 


太郎 编辑 的 内 容 子 编辑 的 内 容 


太朗 和 了 
花子 将 先行 提交 的 太郎 编辑 的 太郎 通过 更 新 花子 提交 的 内 容 并 
内 容 合 并 到 本 地 后 重新 提交 将 其 反映 到 本 地 环境 。 这 样 太郎 
和 花子 的 文件 A 的 内 容 就 统一 了 








锁 模式 的 情况 下 ， 文 件 在 被 编辑 期 间 是 无 法 签 出 ( check out ) 
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的 ， 所 以 不 会 发 生 冲 突 。 合 并 模式 下 任何 时 候 都 可 以 签 出 文件 ， 但 
随 之 而 来 的 是 ， 在 你 签 出 文件 后 到 提交 前 这 段 时 间 ， 如 果 有 人 进行 
了 提交 ， 那 么 你 就 需要 将 这 部 分 修改 合并 到 本 地 代码 后 再 进行 提交 。 

这 时 ， 如 果 文 件 编 辑 的 地 方 重合 的 话 ， 版 本 管理 系统 会 检测 到 
冲突 ， 并 显示 请 手动 修改 冲突 这 样 的 错误 消息 。 这 是 合并 模式 中 版 
本 管理 系统 的 正常 动作 ， 但 习惯 了 锁 模 式 的 人 会 对 此 感到 非常 奇怪 。 

因此 ， 一 些 维护 旧 的 开发 环境 的 团队 有 时 会 根据 锁 模 式 和 合并 
模式 的 这 些 差异 ， 固 执 地 认为 Subversion 和 Git 无 法 锁 住 文件 ， 从 
而 造成 冲突 频 发 ， 无 法 有 效 地 管理 代码 。 这 样 的 现象 在 一 些 习惯 了 
锁 模 式 的 开发 现场 尤为 显著 。 

实则 恰恰 相反 ， 锁 模式 的 版 本 管理 系统 由 于 效率 较 低 ， 无 法 合 
理 地 进行 版 本 管理 的 情况 较 多 。 

锁 模式 的 版 本 管理 系统 在 文件 加 锁 的 情况 下 拒绝 其 他 人 员 对 此 
文件 进行 编辑 ， 这 样 的 确 不 会 造成 冲突 。 但 实际 开发 中 往往 不 允许 
这 样 “ 慢 条 斯 理 " ， 于 是 开发 人 员 就 会 无 视 文 件 被 锁 住 ， 独 自在 本 地 
进行 开发 ， 等 待 锁 解 除 后 再 手动 合并 并 提交 。 

各 个 版 本 管理 系统 可 能 有 所 差异 ， 但 多 数 采 用 锁 模式 的 产品 都 
没有 自动 检查 差异 并 进行 合并 或 者 检测 冲突 等 功能 ， 即 使 有 也 非常 
弱 ， 因 此 容易 发 生 手 动 合并 时 不 小 心 将 他 人 的 修改 覆盖 的 情况 。 并 
且 加 锁 也 不 能 说 是 绝对 的 ， 也 有 将 锁 强 制 解 除 并 覆盖 提交 的 功能 。 

举 一 个 笔者 亲眼 所 见 的 例子 : 一 位 习惯 了 锁 模 式 的 开发 人 员 在 
使 用 Subversion 这 样 的 系统 时 ， 因 为 讨厌 发 生 冲 突 ， 所 以 没有 使 用 
svn update”, 而 是 每 次 都 将 代码 下 载 到 开发 目录 以 外 的 目录 中 , 再 复 
制 自己 编辑 过 的 代码 替换 原 有 代码 后 进行 提交 。 这 种 做 法 真是 令 
吃惊 又 哭笑不得 。 

这 样 的 做 法 的 确 不 会 发 生 冲 突 ， 但 随 之 而 来 的 是 将 频繁 发 生 他 
人 的 修改 被 覆盖 的 事情 。 实 际 上 那个 开发 现场 发 生 的 bug 和 退化 实 
在 太 多 ， 让 人 觉得 项 目 已 经 处 于 骨 溃 的 边缘 。 而 且 笔 者 还 记得 当时 
他 还 被 视 为 现场 比较 有 经 验 的 开发 人 员 ， 所 以 事态 就 更 为 复杂 了 。 

如 果 大 家 的 工作 单位 现在 还 在 使 用 锁 模 式 的 版 本 管理 系统 ， 或 





从 代码 库 中 取得 最 新 的 代码 合并 到 本 地 的 命令 。Git 的 情况 下 是 git pull 


origin master, 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


者 像 上 面 那 样 虽 然 使 用 了 合并 模式 的 系统 但 使 用 方法 有 误 的 话 ， 那 
么 您 可 以 先 和 周围 的 同事 聊 一 下 本 专栏 的 话题 ， 并 试 着 劝说 他 们 改 
变 用 法 。 

但 是 也 有 例外 ， 例 如 在 管理 图 像 这 种 二 进 制 文 件 的 情况 下 ， 因 
为 它 和 代码 这 样 的 文本 文件 完全 不 同 ， 无 法 进行 合并 ， 所 以 用 加 锁 
的 方法 效率 往往 会 高 一 些 。 此 外 ， 在 制作 用 于 重要 发 布 的 包 时 ， 如 
有 果 作 业 时 间 长 达 数 小 时 ， 有 时 就 会 特意 加 锁 以 保证 这 段 时 间 内 绝对 
疫 有 其 他 人 员 的 修正 加 进来 。 虽 然 近 年 来 合并 模 陈 已 经 成 为 主流 ， 
但 大 多 数 的 版 本 管理 系统 对 于 锁 模 陈 也 是 支持 的 。 

使 用 版 本 管理 系统 时 ， 理 解锁 模式 和 合并 模式 这 两 种 版 本 管理 
系统 的 委 异 并 合理 使 用 ， 这 才 是 最 重要 的 。 











e…… 能 够 还 原 到 任意 时 间 点 的 状态 


因为 保存 着 过 去 的 修改 记录 ， 所 以 在 发 生 任何 问题 的 情况 下 ， 例 如 
在 发 生 退化 时 或 者 新 请 加 的 功能 不 再 需要 时 ， 理 所 当然 地 能 够 立即 回 退 
到 过 去 任意 时 间 点 〈 的 版 本 )。 

不 同 的 版 本 省 理 系统 对 于 版 本 的 思考 方式 也 有 所 不 同 。 从 历史 上 来 
说 也 大 致 可 分 为 两 类 : 基于 文件 和 基于 变更 集 ( changeset )。 

例如 CVS 是 基于 文件 的 版 本 管理 ， 即 对 每 一 个 文件 分 别 进 行 版 本 
管理 。 与 之 相对 应 ，Subversion 及 之 后 (包括 Git ) 的 主要 的 版 本 管理 系 
统 都 是 基于 变更 集 的 。 变 更 集 将 对 多 个 文件 的 一 次 修改 看 作 是 理论 上 的 
一 个 单位 。 基 于 变更 集 的 版 本 管理 系统 就 是 以 此 单位 来 分 配 版 本 号 的 。 

基于 文件 的 情况 下， 如果 要 取得 过 去 某 个 时 间 点 的 版 本 ， 束 需要 集 
齐 每 一 个 文件 所 对 应 的 正确 的 版 本 ,例如 文件 A 是 1.1 版 、 文件 B 是 
1.9 版 、 文 件 C 是 2.3 有 版。 与 之 相对 应 ， 基 于 变更 集 的 情况 下 ， 因 为 是 
将 修改 合并 后 进行 管理 的 ， 所 以 要 取得 过 去 某 个 时 间 点 的 版 本 时 ， 只 需 
要 知道 其 版 本 扎 怠 能 够 完整 地 获取 整个 项 目 。 

如 上 所 述 ， 不同 的 版 本 管理 系统 对 于 版 本 管理 的 思考 方式 虽然 有 所 
不 同 ， 但 都 可 以 随时 回 退 到 过 去 的 任意 时 间 点 。 这 是 使 用 版 本 管理 系统 
的 一 个 很 大 的 优势 。 
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一 专栏 基于 文件 和 基于 变更 集 


版 本 管理 的 思考 方式 从 历史 上 来 看 有 基于 文件 和 基于 变更 集 这 
两 种 。 

VSS ( Visual Source Safe ) 这 样 历史 悠久 的 商用 产品 ， 以 及 开 
源 软 件 中 CVS 这 样 较 老 的 工具 ， 都 是 以 基于 文件 的 方式 来 实现 的 。 

那些 大 习惯 于 使 用 VSS 和 CVS 而 不 熟悉 Subversion 及 其 以 后 
的 工具 的 开发 人 员 ， 可 能 是 因为 他 们 以 基于 文件 的 方式 来 理解 版 本 
管理 ， 所 以 往往 会 胡乱 地 把 提交 的 粒度 分 得 很 细 一 一 将 文件 一 个 
一 个 地 进行 提交 。 因 为 VSS 和 CVS 是 基于 文件 的 方式 来 管理 版 本 
的 ， 所 以 逐个 提交 文件 和 打包 一 起 提交 从 结果 上 来 看 是 完全 一 样 的 。 
甚至 可 以 说 在 VSS 和 CVS 的 情况 下 ， 将 文件 一 个 个 地 分 别提 交 更 为 
直观 。 

而 Subversion 及 其 以 后 的 版 本 管理 系统 则 以 变更 集 为 单位 进行 
版 本 管理 。 因 此 如 果 将 文件 一 个 个 地 分 开 提交 ， 变 更 集 也 会 被 分 为 
多 个 ， 这 样 一 来 ， 变 更 集 原 本 具有 的 能 够 为 解决 某 个 问题 而 进行 修 
正 的 意义 就 完全 丧失 了 。 

版 本 管理 系统 进化 为 能 够 对 变更 集 进 行 管 理 的 意义 在 于 让 每 一 
个 版 本 都 有 自己 的 含义 。 因 此 含义 相同 的 修改 就 应 该 置 于 同一 个 变 
更 集中 一 起 提交 。 

如 果 开 发 团队 中 有 成 员 一 直 使 用 VSS 或 CVS 等 工具 ， 并 且 对 其 
他 的 版 本 管理 系统 一 无 所 知 的 话 ， 可 以 向 他 介绍 本 专栏 的 内 容 ， 并 
试 着 让 他 重新 认识 版 本 管理 系统 的 使 用 方法 。 











e…… 能 够 生成 多 个 派生 ( 分 支 和 标签 ) 保留 当时 项 目 状态 的 断面 


版 本 管理 系统 有 分 文 管理 和 标签 管理 的 功能 。 

第 2 草 的 案例 分 析 中 列举 了 无 法 高 效 地 在 新 功能 开发 和 已 发 布 版 本 
的 bug 修正 之 间 切 换 的 问题 ,其 实 只 要 合理 地 进行 分 支管 理 , 就 能 够 解 
决 这 样 的 问题 。 通 过 使 用 分 支管 理 功能 ， 项 目 就 可 以 在 多 个 方向 上 建立 
分 文 ， 例 如 可 以 分 别 建立 新 功能 开发 分 文 和 已 发 布 版 本 的 分 文 。 





吓人 二 2 
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各 个 版 本 管理 系统 在 实现 的 细节 上 可 能 有 所 差异 ， 但 通常 都 具备 
对 分 文 进行 合并 的 功能 。 这 个 功能 越 是 完善 ， 就 越 有 勇气 去 挑战 困难 
的 开发 。 

不 同 的 版 本 管理 系统 在 分 支 切换 、 合 并 的 速度 以 及 正确 性 方面 是 有 
差距 的 ， 近 年 来 Git 是 在 分 文 管理 方面 做 得 最 好 的 。 

标签 管理 是 能 够 对 文件 或 者 变更 集 任意 命名 (打上 标签 ) 的 功能 。 
利用 这 个 功能 可 以 对 过 去 任意 时 间 点 的 系统 快照 进行 管理 。 

可 以 像 阿 尔 法 版 、 贝 塔 版 、 发 布 版 这 样 ， 或 者 像 版 本 0.1、0.2 这 样 
根据 每 个 产品 的 外 部 版 本 号 "来 打上 标签 ， 一 般 都 是 在 到 达 某 节点 时 为 
项 目 打 上 标签 的 。 不 同 版 本 管理 系统 的 标签 功能 在 细微 的 动作 或 规格 上 
可 能 有 所 差异 ， 但 思考 方式 大 致 是 相同 的 。 




















Q) 这 里 并 不 是 指 版 本 管理 系统 内 部 的 版 本 号 。 
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3.2 版 本 管理 系统 的 发 展 变迁 


接 看 我 们 将 按时 间 顺 序 来 介绍 具有 代表 性 的 版 本 管理 系统 。 

版 本 管理 系统 是 高 效 软件 开发 中 必 不 可 少 的 最 基本 的 要 素 。 因 此 在 
软件 开发 的 历史 上 出 现 过 很 多 版 本 管理 系统 的 概 您 ， 这 些 概 念 也 得 到 了 
实现 。 

这 里 让 我 们 来 简单 回顾 一 下 版 本 管理 系统 的 历史 ， 看 一 下 与 时 俱 进 
的 版 本 管理 系统 的 思考 方式 (图 3.1 )， 同 时 也 了 解 一 下 版 本 管理 系统 是 
如 何 发 展 到 现在 被 认为 是 最 有 效率 的 分 布 式 版 本 管理 系统 的 。 


图 3.1 版 本 管理 系统 的 历史 











a ) 
SCM 出 现 以 前 SCM 的 古代 SCM 的 中 世纪 SCM 的 文艺 复兴 
1982 1990 1992 1994 1995 2000 2005 2010 
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※SCM 是 Source Code Management ( 代码 管理 系统 ) 的 简称 。 
本 图 参考 了 “The version control timeline”by The plasticscm blog 
(http:/codicesoftware.blogspot.com/2010/11/versiomncontroltimeline.html )。 
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3.2.1 没有 版 本 管理 系统 的 时 代 ( 20 世纪 70 年 代 以 前 ) 





20 世纪 60 年 代 一 20 世纪 70 年 代 可 以 称 为 “版 本 管理 系统 的 史前 
时 代 ”。 那 时 候 笔 者 还 没有 出 生 。 那 个 时 代 还 没有 可 以 称 为 版 本 管理 系 
统 的 产品 。 

当时 可 能 是 以 日 期 命名 的 目录 来 管理 ， 或 者 制作 表格 文件 来 管理 。 
有 些 开发 团队 也 有 可 能 在 内 部 秘密 地 开发 类 似 于 版 本 管理 系统 的 产品 并 
独自 使 用 。 现 在 已 经 无 从 考证 了 。 











3.2.2 RCS 的 时 代 ( 20 世纪 80 年 代 ) 


seeeeeseeeeeeeeseeeseeeeseseeeseeeeeeeeeseeeeeeeseeeeeeee 


现在 某 些 UNIX 操作 系统 上 仍然 捆绑 安装 的 RCS ( Revision Control 
System ) 是 于 1982 年 发 布 的 。 它 以 省 理 本 地 机 各 上 的 文件 为 目的 ， 是 
最 早 的 真正 意义 上 的 版 本 管理 系统 。 

RCS 具备 了 对 文件 之 间 的 差异 进行 管理 这 种 基本 的 版 本 管理 机 制 ， 
但 还 没有 考虑 到 多 人 开发 的 情况 ， 原 因 是 要 将 管理 的 版 本 和 多 个 人 进行 
共享 是 非常 困难 的 ~。 因 此 ,这 只 是 一 款 在 本 地 机 器 上 对 文件 进行 管理 的 














3.2.3 ”CVS 的 诞生 ( 20 世纪 90 年 代 ) 


seeeeeseeeesseeeeseeseeeeeeseseeeeeeseeeseeseeeeeeseeeeeee 





RCS 之 后 也 发 布 过 一 些 版 本 管理 系统 ， 但 都 是 只 能 在 本 地 机 器 上 对 
文件 进行 管理 ， 对 多 人 开发 的 文 持 不 够 这 一 功能 上 的 缺陷 一 直 没 有 得 到 
改善 。 

改变 上 述 状况 的 是 1990 年 左右 发 布 的 CVS (Concurrent Versions 
System )。 通 过 CVS 名 字 中 的 Concurrent (并行 ) 就 能 知道 ， 这 是 一 球 
为 了 支持 多 人 并 行 开 发 而 设计 的 系统 。 

和 RCS 不 同 ，CVS 采用 了 客户 端 / 服 务 带 的 染 构 ， 通 过 CVS 服务 





中 当然 也 并 非 完 全 不 可 能 ， 通 过 共享 目录 ， 在 rcs 文件 中 粘贴 符号 链接 ， 还 是 可 以 
实现 共享 的 。 那 时 候 一 般 所 有 的 开发 都 在 一 台 机 器 上 进行 。 
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器 使 多 人 共享 代码 成 为 可 能 。 从 服务 顺 签 出 代码 进行 编辑 ， 然 后 再 提交 
到 服务 器 ， 这 种 现在 看 来 理 所 应 当 的 作业 流程 ， 可 以 说 是 由 CVS 最 先 
确立 的 。CVS 还 采用 了 合并 模式 来 解决 冲突 ， 使 得 多 人 并 行 编 辑 同 一 文 
件 变 得 容易 进行 。 

但 另 一 方面 ， 版 本 管理 仍 采用 基于 文件 的 方式 实现 ， 每 一 个 文件 都 
有 自己 独立 的 版 本 号 。 因 为 没有 变更 集 的 概念 ， 所 以 发 生 bug 时 要 找 出 
相关 的 一 系列 文件 及 其 版 本 号 是 一 件 比 较 困 难 的 事情 。 

虽然 CVS 实现 了 分 支管 理 和 标签 管理 ,但 创建 分 支 是 重量 级 的 作 
业 。 特 别 是 将 分 支 再 度 合并 回 主干 时 的 作业 异常 困难 ， 根 据 项 目的 规 
模 ， 有 时 不 得 不 任命 专门 的 人 员 来 进行 此 作业 。 

CVS 是 最 早 考虑 到 使 用 网 络 的 版 本 管理 系统 ， 并 且 属 于 开源 软件 ， 
使 用 是 免费 的 ， 所 以 从 20 世纪 90 年 代 开 始 就 被 广泛 使 用 。 在 一 些 开 发 
现场 ， 至 今 仍然 在 使 用 CVS。 























3.2.4 VSS.、Perforce 等 商用 工具 的 诞生 ( 20 世纪 90 年 代 ) 





在 CVS 被 发 布 的 几乎 同一 时 期 ， 各 个 软件 企业 也 发 布 了 多 款 商用 
的 工具 。 具 有 代表 性 的 是 PVCS 、ClearCase、VSS 和 Perforce 等 。 

很 多 历史 较 久 的 开发 团队 至 今 还 使 用 着 上 述 版 本 管理 系统 。 它 们 的 
后 继 产 品 如 今 多 是 将 项 目 管理 等 功能 整合 起 来 ， 以 ALM ( Application 
Lifecycle Management ) 工具 的 形式 出 售 。 

这 些 商 用 工具 和 CVS 相同， 也 来 用 客户 病 / 服务 如 模式 。 各 个 产品 
在 实现 的 细节 上 有 所 差异 ， 但 大 多 都 是 以 锁 模 式 来 消除 冲突 ， 并 基于 文 
件 进 行 版 本 管理 。 

当然 ， 这 是 20 世纪 90 年 代 当 时 的 情况 ， 这 些 工 具 的 最 新 版 本 改进 
并 添加 了 各 类 功能 ， 都 有 着 易于 使 用 的 特性 。 

20 世纪 90 年 代 出 现 的 这 些 商 用 工具 各 具 特 色 ， 被 市 场 广泛 接受 ， 
但 它们 都 没 能 解决 分 文 管理 和 合并 困难 的 问题 。 
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3.2.5 Subversion 的 诞生 ( 2000 年 以 后 ) 


进入 2000 年 后 ， 作 为 CVS 的 后 继 ，Subversion 诞生 了 。 它 和 CVS 

- 样 采 用 了 客户 端 / 服 务 需 模式 ， 通 过 合并 模式 来 消除 冲突 。 同 时 还 引 

人 了 变更 集 的 概念 ， 使 得 赋予 相关 联 的 文件 相同 的 版 本 号 成 为 可 能 。 据 
此 ，busg 的 调查 也 变 得 容易 不 少 。 

并 且 Subversion 还 可 以 对 CVS 不 文 持 的 文件 名 和 目录 和 名 的 修改 和 
删除 操作 进行 追踪。 对 项 目的 定理 也 更 为 灵活 ， 这 也 是 Subversion 的 
特色 。 

Subversion 可 以 说 是 现在 最 普及 的 版 本 管理 系统 。 特 别 是 它 的 
GUI 客户 痊 工具 TortoiseSVN 非常 完善 ,被 Windows 操作 系统 的 用 户 
广泛 接受 。 

虽然 分 支 的 创建 已 经 变 得 简单 且 快 速 ， 但 是 将 分 文 合并 回 主干 的 作 
业 依然 非常 费劲 。 因 此 多 数 开发 现场 都 尽量 避免 使 用 合并 ， 把 分 文 的 建 
立 控制 在 最 小 限度 。 
































3.2.6 分布 式 版 本 管理 系统 的 诞生 ( 2005 年 以 后 ) 


上 面 介 绍 的 CVS、Subversion 以 及 各 个 商用 的 工具 都 是 基于 客户 端 
/服务 套 模 式 来 实现 的 。 代 码 库 只 存在 于 服务 硕 上 ， 各 开发 人 员 从 服务 
咒 上 下 载 代 码 ， 编 辑 后 再 提交 到 服务 硕 。 

2005 年 出 现 的 Git 改变 了 上 述 方式 。 

Git 的 开发 者 是 著名 的 Linux 之 父 Linus Torvalds。Linux 社区 原本 使 
用 的 是 专 有 “的 分 布 式 版 本 管理 系统 ( Distributed Version Control System， 
DVCS ) BitKeeper ,但 后 来 因为 某 些 原因 不 得 不 放弃 使 用 BitKeeper， 于 
是 就 开始 了 Git 的 开发 。 

Git 出 现 之 后 ， 开 源 项 目 业 界 使 用 分 布 式 版 本 管理 系统 的 项 目 逐 渐 




















由 特定 的 软件 生产 商 发 布 的 规格 等 不 公开 的 产品 。 
http://www.bitkeeper.com/ 
放弃 BitKeeper 的 原因 比较 复杂 ， 其 中 涉及 了 商业 协议 等 。 有 兴趣 的 读者 可 以 参 
考 http:/www.path8.nettn/archives/6039。 译 者 注 
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增加 ， 分 布 式 版 本 管理 系统 逐渐 扎根 下 来 。 如 今 已 经 普及 到 了 开源 项 目 
以 外 的 一 般 项 目 中 。 分 布 式 版 本 管理 系统 中 除了 最 有 名 的 Git 之 外 ， 其 
他 还 有 Mercurial 、Bazaar 等。 

分 布 式 版 本 管理 系统 最 显著 的 特征 就 是 没有 中 央 代 码 库 ， 完 全 采用 
peer to peer 的 模式 。 开 发 人 员 并 不 是 从 中 央 代 码 库 中 下 载 代 但 ， 而 是 将 
代码 库 完 整地 克隆 到 本 地 机 右 上， 使 得 本 地 机 各 上 保存 有 完整 的 代码 库 
备份 ”。 据 此 , 不 需要 借助 网 络 就 能 够 完成 所 有 的 操作 , 因此 具有 提交 等 
命令 执行 速度 快 的 特征 。 因 为 回 本 地 代码 库 提交 的 速度 很 快 ， 所 以 可 以 
频繁 地 进行 提交 ， 以 降低 工作 成 末 丢 失 的 风险 。 

分 文 也 是 一 样 ， 由 于 只 需 目 己 本 地 的 代码 库 就 能 建立 分 支 ， 因 此 在 
想 进 行 某 种 符 试 时 ， 就 可 以 随意 地 建立 分 文 。 这 和 Subversion 之 前 的 只 
能 在 中 央 服 务 右 上 建立 分 文 的 中 央 集 权 型 版 本 管理 系统 有 很 大 的 区 别 。 

当然 ，Subversion 之 前 的 产品 中 已 经 实现 的 变更 集 的 管理 和 合并 模 
式 的 冲突 消解 等 功能 ，Git 都 继承 了 下 来 。 

总 之 ， 提 交 、 分 文 、 合 并 的 低 开 销 ， 只 要 正确 提交 就 几乎 不 会 丢失 
作业 ， 试 验 性 质 的 分 文 建立 方便 ， 能 够 实现 灵活 的 工作 流程 ， 这 些 都 是 
Git 比较 主要 的 特征 。 分 布 式 版 本 省 理 系统 的 出 现 ， 可 以 说 是 版 本 管理 
系统 和 团队 开发 的 重大 进步 。 

但 是 难点 在 于 学 习 成 本 。 由 于 分 布 式 版 本 管理 系统 (在 系统 上 ) 没 
有 中 央 代 码 库 的 概念 ， 和 之 前 的 版 本 管理 系统 的 思想 方式 有 着 根本 性 的 
差异 ， 因 此 初次 使 用 的 人 基本 都 会 感到 不 知 所 措 。 

但 分 布 式 版 本 管理 系统 是 值得 花费 这 样 的 成 本 的 。 世 界 上 几乎 所 有 
的 开源 项 目 都 采用 了 分 布 式 版 本 管理 系统 ， 从 这 点 就 能 看 出 。 
































3.2.7 ”番外 篇 : GitHub 的 诞生 


eeeeeeseeeeeseeeeseeeeeeeseseeeeseeeeseesseeeseeseeeeseeseeeeseeeeeeeeeeseseeeeeee 





虽然 有 些 偏 离 版 本 管理 系统 的 历史 ,但 这 里 我 们 还 是 要 提 下 
GitHub。 
(D http://mercurial.selenic.com/ 


©) http://bazaar.canonical.conmy/ 
(3) 虽说 机 制 上 不 需要 中 央 代码 库 ， 但 实际 使 用 中 往往 还 是 会 设立 中 央 代 码 库 。 
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GitHub 是 2008 年 诞生 的 Git 项 目的 在 线 托 管 服务 。 “社交 编程 ”这 
个 标语 可 能 更 为 出 名 "。 

GitHub 之 前 也 有 代码 托管 服务 ,如 SourceForge 和 assembla“ 等 。 这 
些 服务 的 特点 是 能 够 方便 地 托管 代码 ， 还 文 持 多 人 开发 和 缺陷 管理 ， 
此 主要 在 开源 软件 界 被 广泛 使 用 。 

GitHub 是 上 述 服务 的 Git 版 ， 和 上 述 托管 服务 相 比 ，GitHub 更 为 流 
行 和 普及 。 

GitHub 流行 起 来 的 原因 有 很 多 ， 其 中 最 主要 的 是 得 益 于 Fork 和 
Pull Request 这 两 个 特色 功能 。 如 采 别 人 的 项 目 中 有 你 感 兴趣 的 地 方 ， 可 
以 方便 地 克隆 该 项 目 (Fork ) 并 添加 修改 ， 再 发 送 补 丁 申 请 将 自己 的 修 
改 反 映 到 原来 的 项 目 中 (Pull Request )。 

之 前 的 中 央 集 权 型 版 本 管理 系统 是 无 法 实现 上 述 功能 的 。 首 先是 无 
法 对 已 有 项 目 进行 克隆 。 男 外 ， 发 送 给 项 目的 补丁 (修改 ) 如 果 不 能 立 
即 反 映 到 项 目 中 ， 也 得 不 到 保存 ， 最 终 就 会 丢失 。 

GitHub 的 成 功 之 处 可 以 说 在 于 将 分 布 式 管理 系统 ( Git ) “不 存在 中 
央 代 码 库 ” 这 一 特征 所 具有 的 潜能 最 大 限度 地 激发 了 出 来 。 原 本 以 Git 
为 代表 的 分 布 式 版 本 管理 系统 有 着 运行 速度 快 、 建 立 分 文 简 单 快捷 、 合 
并 方便 等 特点 ， 但 同时 也 存在 API 比较 复杂 ， 不 了 部 悉 的 话 很 难 灵 活 应 
用 这 样 的 问题 。 

GitHub 可 以 说 是 通过 易 用 易 仅 的 UI 和 高 超 的 设计 灵感 将 Git 的 潜 
刀 宛 分 涛 公国 来 、 一 下 于 改变 了 天 公 人 员 的 位 弄 。 

如 今 参 加 开源 项 目的 门 坎 已 经 大 大 降低 。 如 果 开 源 代码 中 有 什么 看 
不 惯 的 地 方 ， 或 者 发 现 了 bug， 都 可 以 Fork 并 进行 修改 。 

修改 顺利 的 话 ， 可 以 癌 原 来 的 项 目 进行 Pull Request， 将 修改 反映 到 
项 目 中 。 这 样 就 对 开源 项 目 做 出 了 自己 的 贡献 ， 不 需要 其 他 任何 杂 七 杂 
八 的 事情 。 

如 此 便捷 的 GitHub， 如 果 只 用 在 开源 软件 界 就 太 浪 费 了 。 事 实 上 ， 












































QD 到 2014 年 ，GitHub 网 站 上 社交 编程 这 个 标语 已 经 没有 了 。 
@ http://sourceforge.net/ 
3) https://www.assembla.com/ 
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世界 上 的 很 多 公司 都 已 经 在 使 用 GitHub 开发 自己 的 产品 。 可 以 毫 不 硅 
张 地 说 日 本 国内 主要 的 互联 网 服务 提供 商 几 乎 都 在 使 用 GitHub。 

笔者 现在 所 属 的 公司 也 在 使 用 GitHub。 一 旦 了 解 了 GitHub 的 便利 
性 和 分 布 式 版 本 管理 系统 的 自由 性 ， 就 很 难 再 回 到 之 前 的 中 央 集 权 型 版 
本 管理 系统 了 。 听 说 一 些 资深 的 工程 师 ， 换 工作 时 都 会 确认 对 方 企业 是 
否 使 用 GitHub。 

GitHub 的 共享 代码 库 是 免费 的 ， 但 私有 的 代码 库 还 是 收费 的 ， 这 点 
请 注意 。 并 且 GitHub 还 有 供 公 司 内 部 局 域 网 使 用 的 产品 GitHub 
Enterprise"。 企 业 在 开发 产品 时 使 用 私有 代码 库 的 花费 “或 者 GitHub 
Enterprise 的 花费 需要 预先 纳入 到 项 目 预 算 中 。 但 这 样 的 花费 还 算是 物 
有 所 值 的 。”” 
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3.2.8 ”版 本 管理 系统 的 导入 情况 


走马 观 花 地 看 了 一 遍 版 本 管理 系统 的 历史 。 从 没有 版 本 管理 系统 到 
RCS 的 出 现 ，CVS、Subversion 的 出 现 ， 再 到 分 布 式 版 本 管理 系统 的 
Git 的 出 现 ， 仅 仅 用 了 20 年 的 时 间 。 在 这 期 间 ， 版 本 管理 系统 从 基于 文 
件 到 基于 变更 集 、 从 锁 模式 到 合并 模式 、 从 中 央 集 权 型 版 本 管理 系统 到 
分 布 式 版 本 管理 系统 ， 有 了 巨大 的 进步 。 这 些 进步 可 以 说 都 是 人 们 为 了 
使 多 人 同时 并 行 开发 更 容易 ， 以 及 提高 开发 速度 而 努力 的 结果 。 

取得 这 样 的 进步 只 用 了 20 年 的 时 间 ， 可 以 说 是 相当 迅速 了 。 当 时 











https://enterprise.github.com/ 
https://github.com/pricing 
根据 代码 库 和 用 户 数量 的 不 同 ， 有 各 种 价格 的 套餐 。 具 体 请 参考 GitHub 的 网 站 。 
也 有 和 GitHub 功能 几乎 完全 相同 ， 并 且 私 有 代码 库 在 一 定 程度 上 也 可 以 免费 使 
用 的 服务 ， 那 就 是 Bitbucket ( https://bitbucket.org )。Bitbucket 原本 是 Mercurial 这 
款 分 布 式 版 本 管理 系统 的 托管 服务 ， 现 在 也 支持 Git 了 。 在 公司 内 部 导入 GitHub 
之 前 ， 可 以 先 使 用 Bitbucket 的 私有 代码 库 ， 让 开发 人 员 先 体验 一 下 分 布 式 版 
本 管理 系统 和 Pull Request， 之 后 再 正式 地 导入 GitHub。 或 者 就 这 样 继续 使 用 
Bitbucket 也 是 一 个 不 坏 的 选择 。 
@ 在 某 些 情况 下 ， 可 能 会 由 于 安全 策略 的 问题 而 不 允许 使 用 GitHub 这 样 的 外 部 服 
务 ， 或 者 没有 使 用 GitHub Enterprise 的 预算 。 这 时 可 以 选择 使 用 Gitlab (http:/ 
gitlab.org )、GitBucket ( https://github.com/takezoe/gitbucket ) 等 GitHub 的 克隆 。 


©OOOO 
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刚刚 开始 工作 的 20 岁 左右 的 工程 师 ， 如 今 已 40 岁 左 右 ， 并 成 为 了 开发 
现场 的 中 坚 力量 。 到 了 40 多 岁 这 个 年 纪 ， 很 多 工程 师 都 已 经 成 为 项 目 
经 理 ， 或 者 对 工具 和 技术 的 选择 拥有 决定 权 。 当 然 也 有 人 依然 在 开发 现 
场 编写 代码 。 

寺 别 是 在 日 本 ， 技 术 方 面 的 信息 传人 比 起 美国 要 晚 一 些 。20 世纪 
90 年 代 初 出 现 的 CVS 好 像 到 90 年 代 后 期 才 开 始 被 广泛 使 用 ，2000 年 
出 现 的 Subversion 到 2004 一 2005 年 才 逐 渐 普 及 。 至 于 2005 年 出 现 的 
Git， 到 2010 年 才 有 一 部 分 先进 的 公司 开始 使 用 。 直 到 2014 年 ， 多 数 互 
联网 公司 才 开 始 讨 论 采 用 Git。 这 些 都 是 事实 。 

如 今 还 在 使 用 20 世纪 90 年 代 发 布 的 商用 版 本 管理 系统 的 公司 多 数 
是 企业 级 的 系统 集成 商 〈SIer )。 特 别 是 日 本 企业 ， 它 们 有 着 只 要 系统 尚 
可 使 用 就 不 会 强行 升级 这 样 独特 的 文化 ， 状 况 就 可 想 而 知 了 。 

你 所 在 的 公司 在 使 用 Git 或 者 GitHub 吗 ? 如 果 是 的 话 那 么 你 是 幸运 
的 。 你 所 在 的 是 非常 理解 技术 的 优秀 的 公司 ， 或 者 是 最 近 成 立 的 创新 公 
司 。 请 珍惜 这 样 的 环境 。 

如 此 幸运 的 人 应 该 不 会 太 多 。 比 如 有 些 开 发 现场 的 项 目 经 理 当 年 在 
一 线 工 作 时 只 能 采用 CVS 这 样 基于 文件 的 版 本 管理 ， 或 者 用 惯 了 VSS 
这 样 基 于 锁 的 难以 并 行 开发 的 系统 ， 这 样 的 开发 现场 往往 不 会 使 用 Git 
或 GitHub。 为 外 ， 由 于 企业 文化 保守 ， 至 今 仍 在 使 用 VSS 的 企业 ， 以 
及 只 是 形式 上 导入 了 了 Subversion， 用 法 和 VSS 的 时 候 基 本 没有 区 别 的 企 
业 也 是 比较 多 见 的 。 

再 重复 一 下 ， 版 本 管理 系统 只 有 短 短 20 年 的 历史 *。 

假如 你 的 上 司 、 你 所 在 的 公司 对 于 版 本 管理 的 理解 不 足 ， 还 在 使 用 
旧 的 模式 进行 管理 ， 这 是 对 技术 方面 的 懈 合 而 造成 的 结果 。 在 认识 到 这 
一 点 的 基础 上 ， 请 从 自己 开始 努力 ,来 改变 这 样 的 公司 文化 。 









































@ 不 只 是 版 本 管理 系统 ， 本 书 中 出 现 的 工具 和 插件 都 在 这 不 到 20 年 的 时 间 内 有 了 
巨大 的 进步 。 
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3.3 ”分 布 式 版 本 管理 系统 


3.3.1 使 用 分 布 式 版 本 管理 系统 的 5 大 原因 


分 布 式 版 本 管理 系统 的 优点 有 以 


seeeseeseeeseeeeeseeeeseeeeseeseeeseeee 





2014 年 最 先进 的 版 本 管理 系统 
下 5 个 。 


e@…… 能 将 代码 库 完整 地 复制 到 本 地 


这 是 和 中 央 集 权 型 版 本 管理 系统 的 主要 差异 。 之 后 列举 的 优点 几乎 
都 是 基于 这 个 特点 的 。 








| 运行 速度 快 


本 地 机 和 需 上 存放 有 所 有 的 文件 ， 因 此 通信 开销 低 ， 提 交 、 分 文 、 合 
并 等 操作 速度 快 ， 这 是 分 布 式 版 本 管理 系统 的 一 大 优势 。 








e@…… 临时 作业 的 提交 易于 管理 


和 中 央 集 权 型 版 本 管理 系统 不 同 ， 分 布 式 版 本 管理 系统 可 以 在 不 影 
啊 全 体 代 码 库 的 情况 下 在 本 地 提交 代码 。 这 样 可 以 方便 地 保存 临时 作 
业 ， 有 助 提 高 开发 效率 。 

男 一 个 优点 是 可 以 不 用 考虑 对 整体 的 影响 ,方便 地 进行 实验 性 质 的 
开发 。 











@…… 分 支 、 合 并 简单 方便 


相同 的 内 容 已 经 提 到 过 很 多 次 了 ， 分 文 建立 简单 、 快 速 ， 不 仅 能 提 
高 开发 速度 ， 也 不 会 阻碍 你 的 各 种 尝试 ， 这 也 是 一 大 优点 。 
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e@…… 可 以 不 受 地 点 的 限制 进行 协作 开发 


借助 本 地 环境 中 保存 有 全 部 文件 这 一 特性 ， 无 论 在 无 法 连接 互联 网 
的 离线 环境 ， 例 如 在 乘坐 飞机 时 ， 还 是 访问 互联 网 比较 困难 的 偏远 地 
区 ， 都 能够 顺利 地 进行 开发 。 可 以 说 最 适合 不 限 地 区 和 国家 的 开源 代码 
项 目 了 上 了。 并且 该 特性 最 近 还 起 到 了 将 软件 开发 企业 从 地 域 限制 中 解放 出 
来 的 作用 ， 以 美国 西海 赃 的 企业 为 中 心 ， 开 发 人 员 的 多 国籍 化 、 多 地 区 
化 正在 推进 之 中 。 





3.3.2 ”分布 式 版 本 管理 系统 的 缺点 


分 布 式 版 本 管理 系统 作为 当前 最 先进 的 版 本 管理 系统 ， 基 本 上 是 优 
点 占 大 部 分 。 但 缺点 或 者 说 需要 注意 的 地 方 也 并 不 是 没有 。 


eeeeeeeeeeeeeeeseseeeseseeseseeseeeeeeseeeeseeeeeeeseeeeseeeeseeeeeeee 








e@…… 系统 中 没有 真正 意义 上 的 最 新 版 本 


因为 系统 中 没有 中 央 数 据 库 ， 所 以 也 不 存在 最 新 版 本 这 一 概念 。 
Subversion 的 话 ， 最 新 版 本 目 然 就 是 trunk 上 的 HEAD。 而 分 布 式 版 本 
管理 系统 的 情况 下 ， 如 有 果 没 有 在 运用 策略 上 确定 中 央 数 据 库 ， 那 么 最 新 
版 本 也 就 无 从 谈 起 。 


@…… 没有 真正 意义 上 的 版 本 号 


没有 中 央 代 码 库 就 意味 着 不 知道 哪个 是 最 新 版 本 ， 或 者 说 哪个 都 有 
可 能 是 最 新 版 本 。 也 就 是 说 ， 即 使 像 Subversion 那样 连续 地 分 配 版 本 号 
1、2、3 也 没有 任何 意义 。 例 如 版 本 号 231， 至 于 代码 库 A 的 231 版 本 
和 代码 库 A' 的 231 版 本 哪个 是 新 版 本 ， 就 完全 不 知道 了 。 

因此 ， 分 布 式 版 管理 系统 为 每 一 个 变更 集 分 配 了 GUID ”( Globally 
Unique IDentifier )。 也 就 是 说 ， 并 不 是 管理 版 本 的 新 旧 ， 而 是 管理 变更 
集 的 唯一 性 。 这 样 的 管理 方法 与 合并 的 便利 性 之 间 有 着 密切 的 关联 ， 但 























(DD 是 指 全 局 唯一 标识 符 。 原 本 是 不 重复 的 128 位 的 整数 ， 考 虑 到 可 读 性 方面 的 问 
题 ， 分 布 式 版 本 管理 系统 在 使 用 时 采用 了 “26fde9ed06bc4d0f8773cb399e73eb63” 
这 样 的 32 位 十 六 进 制 的 表现 形式 。 
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开发 人 员 之 间 的 对 话 就 比较 麻烦 了 。 这 是 因为 必须 用 隐 上 星 的 GUID 来 称 
呼 修改 。 比 如 “231 版 本 ”, 就 不 得 不 改称 为 ““26fde9ed06bc4d0f8773cb3 
99e73eb63 ”的 修改 ”， 如 果 没 有 习惯 的 话 ， 还 真是 让 人 吃不消 。 


e@…… 工作 流程 的 配置 过 于 灵活 ， 容 易 产生 混乱 


分 布 式 版 本 管理 系统 中 不 存在 中 央 代 码 库 ， 任 何 一 个 代码 库 都 是 等 
价 、 平 行 的 。 系 统 上 可 以 从 任意 一 个 代码 库 癌 男 一 个 代码 库 自 由 地 通过 
Push/Pull 来 发 送 修 改 补丁 。 这 样 的 形式 能 够 灵活 地 组 建 工 作 流程 ， 可 以 
算得 上 是 优点 。 但 如 果 团 队 成 员 没 有 习惯 的 话 ， 反 而 容易 产生 混乱 。 

因此 ， 实 际 运用 中 会 设立 中 央 代 码 库 ， 各 开发 人 员 从 中 央 代 码 库 克 

条 代码 进行 开发 ， 这 是 比较 常规 的 做 法 。 如 此 一 来 ， 实 际 运用 中 使 用 
GitHub 就 成 了 最 方便 的 选择 ， 这 样 做 的 开发 团队 也 比较 多 见 。 

















e…… 思维 方式 的 习惯 需要 一 定 的 时 间 


如 上 所 述 ， 分 布 式 版 本 管理 系统 的 缺点 的 根本 原因 在 于 : 在 使 用 分 
布 式 版 本 管理 系统 时 需要 在 至 今 为 止 的 中 央 集 权 型 版 本 管理 系统 的 基础 
上 进行 范式 转变 ”。 

分 布 式 版 本 管理 系统 和 CVS、Subversion、VSS、Perforce 的 构造 都 
不 类 似 ， 所 以 越 是 习惯 以 前 的 版 本 管理 系统 的 人 ， 在 一 开始 时 就 越 是 容 
易 感 到 困惑 ， 操 作 也 容易 失败 。 这 也 是 导入 分 布 式 版 本 管理 系统 最 大 的 
壁垒 ， 好 在 现在 已 经 出 现 了 较 多 的 入 门 书籍 可 供 参 考 。 











由 即 思维 方式 的 根本 转变 。 


译 者 注 
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3.4 如 何 使 用 版 本 管理 系统 


从 这 里 开始 我 们 一 起 来 看 一 下 为 了 顺利 地 推进 团队 开发 ， 我 们 应 该 
用 版 本 管理 系统 具体 管理 些 什么 ， 以 及 如 何 管理 。 





3.4.1 前 提 


seeeseeeeeesseeseeseeseeeseseeeeseeeeeseeeseeseeeeeeeseeseeseeeseeseeeseeeeeeeeeseeseeseeseeeseeseeseeseseeeseeeseeseeeseeeseeeeseeseeseeeeeseeeseeeeeeeseeeeeseeeeseeeee 








本 市 的 内 容 在 没有 特殊 说 明 的 情况 下 ， 都 是 使 用 Git 和 GitHub 来 进 
行 说明 的 。 但 这 里 不 会 对 Git 的 安装 方法 和 基本 命令 等 的 使 用 方法 进行 
说 明 。 另 外 ， 虽 然 文中 会 出 现 一 些 Git 命令 ， 但 也 仅仅 展示 了 这 些 命令 
的 一 般 用 法 ， 这 点 请 注意 。 

Git 的 使 用 门槛 虽然 有 些 高 ， 但 它 非常 灵活 易 用 ,并且 几乎 包罗 了 
所 有 的 需求 和 用 例 。 因 此 当 你 觉得 Git 无 法 实现 某 些 功能 时 ， 可 以 查看 
一 下 相关 网 页 “或 参考 书籍 ， 还 有 man ”， 一 定 能 找到 实现 的 方法 。 








3.4.2 ”版 本 管理 系统 管理 的 对 象 


应 该 用 版 本 管理 系统 进行 管理 的 对 象 可 谓 是 多 种 多 样 ， 用 一 句 话 来 
概括 就 是 “能 够 管理 的 对 象 都 应 该 用 版 本 管理 系统 进行 管理 ”。 
根据 《程序 员 修 炼 之 道 : 从 小 工 到 专家 》 一 书 中 的 解释 ， 其 理由 如 下 。 











由 Git 拥有 非常 灵活 的 命令 体系 ,执行 相同 的 内 容 可 以 有 多 种 做 法 。 
中 可 以 参考 如 下 资料 。 
猴子 都 能 懂 的 GIT 入 门 
http://backlogtool.com/git-guide/cn/ 
* Pro Git 
http://git.oschina.net/progit/ 
(3) 在 UNIX/Linux/MacOSX 环境 下 执行 man git 命令 就 会 显示 Git 的 帮助 手册 。 
由 Andrew Hunt、David Thomas 著 ， 马 维 达 译 ， 电 子 工 业 出 版 社 ，2011 年 1 月 。 
译 者 注 
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把 项 目 整体 纳入 到 代码 管理 系统 之 中 ， 这 样 的 做 法 隐 含 者 显著 的 优 
点 。 那 就 是 能 够 实现 输出 文件 的 build 作业 自动 化 ， 并 且 能 够 反复 执行 。 


重要 的 是 通过 使 用 版 本 管理 系统 来 管理 所 有 项 目 发 布 所 需要 
的 文件 ， 这 样 就 可 以 实现 build 的 自动 化 。 如 果 为 了 生成 产品 发 布 
所 需要 的 文件 ， 每 次 都 要 委托 QA 部 门 “ 进 行 测试 ,或 者 委托 运 维 
部 门 手 动 生 成 文件 ， 那 是 不 可 能 实现 优质 快速 的 开发 的 。 





上 述 思 考 方式 称 为 持续 集成 〈Continuous Integration，CI ) 和 持续 交 
付 (Continuous Delivery，CD )。CI 和 CD 在 这 几 年 已 经 成 为 了 热门 词 
汇 ， 其 实在 很 久之 前 已 经 有 一 部 分 开发 团队 对 此 进行 了 实践 。 二 者 相关 
的 内 容 将 分 别 在 第 5 草 和 第 6 章 进行 说 明 。 

为 了 实现 CI 和 CD 这 样 的 实践 ， 首 要 前 提 就 是 使 用 版 本 管理 系统 
对 所 有 必要 的 信息 进行 适当 的 管理 。 一 般 我 们 所 说 的 应 该 管理 的 信息 主 
要 包括 以 下 这 些 。 











。 代 码 
。 需求 定义 、 设 计 资 料 等 文档 
。 数据 库 模式 、 数 据 

。 中间 件 等 的 配置 文件 

。 库 的 依赖 关系 定义 


版 本 管理 系统 最 基本 的 功能 就 是 对 代码 进行 管理 。 从 版 本 管理 系统 
也 称 为 代码 管理 系统 ( Source Code Management，SCM ) 就 可 以 看 出 ， 
版 本 管理 系统 原本 就 是 为 了 管理 代码 而 设计 的 。 

优秀 的 团队 开发 ， 首 先 就 要 从 对 代码 进行 版 本 管理 开始 做 起 。 这 里 
所 说 的 代码 也 包括 测试 代码 。 测 试 代 人 码 的 写法 将 在 第 5 章 中 进行 讲解 ， 
对 测试 代码 也 要 进行 版 本 管理 。 


@ 负责 确保 软件 质量 的 部 门 。 
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e…… 需求 资料 、 设 计 资料 等 文档 


对 项 目 相关 的 文档 也 应 该 尽 可 能 地 进行 版 本 管理 。 根 据 所 属 团队 和 
项 目的 不 同 ， 有 些 文档 是 由 销售 人 员 或 者 企划 人 员 撰 写 的 ， 有 些 是 由 程 
序 员 上 自己 写 的 ,可谓 是 多 种 多 样 。 文 档 一 般 反 映 了 项 目的 起 因 ， 即 为 了 
解决 什么 问题 而 开展 的 ， 是 为 了 和 后 继 者 交接 工作 内 容 所 写 的 非常 重要 
的 资料 。 并 且 随 着 项 目的 进行 ， 对 文档 进行 相应 的 修改 也 是 党 有 的 事 
情 ， 因 此 要 尽量 一 同 进 行 版 本 管理 。 

如 果 可 能 的 话 ， 请 尽量 用 文本 文件 的 形式 来 管理 这 些 文档 。 现 在 已 
经 有 了 Markdown” 、Textile”、reStructuredText 等 多 种 格式 , 它们 虽然 是 
文本 形式 ， 但 在 一 定 程 度 上 也 能 制作 出 漂亮 的 文档 。 


























e…… 数据 库 模式 、 数 据 


现在 可 以 说 几乎 不 存在 不 使 用 数据 库 的 Web 应 用 程序 。 这 也 意味 者 
没有 理由 不 对 数据 库 模 式 和 数据 “进行 版 本 管理 。 

正如 我 们 在 第 2 章 的 案例 中 所 见 到 的 那样 ， 是 否 能 够 管理 好 数据 库 
模式 及 数据 将 直接 决定 团队 开发 是 否 能 够 顺利 进行 。 本 章 稍 后 会 介绍 成 
功 管理 数据 库 的 机 制 。 


























@.……… 配置 文件 


应 用 程序 一 般 都 会 使 用 到 一 些 Web 应 用 程序 框架 以 及 中 间 件 。 这 些 
Web 应 用 程序 的 框架 和 中 间 件 的 配置 文件 也 应 该 进行 版 本 管理 。 

根据 部 署 环境 的 不 同 ， 配 置 文件 中 的 值 也 会 相应 地 改变 ， 因 此 就 
必须 根据 环境 把 配置 文件 分 开 来 。Ruby on Rails 和 Play Framework 等 
最 近 的 Web 应 用 程序 框架 提供 了 针对 不 同 环境 进行 配置 的 机 制 ， 可 以 
直接 使 用 。 








http://daringfireball.net/projects/markdown/ 

http://textile.sitemonks.com/ 

http://docutils.sourceforge.net/rst.html 

这 里 的 数据 不 是 指 随 着 用 户 的 操作 等 而 增加 的 事务 数据 ， 而 是 指 初始 化 设置 这 样 
的 程序 启动 所 必需 的 主 数 据 ( master data )。 


©OOOO 
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但 是 ，Apache、 es memcached 等 应 用 程序 的 配置 文件 大 
都 没有 提供 根据 环境 进行 配置 的 机 制 ， 这 方面 只 能 目 己 花 一 些 工 夫 了 。 


e…… 库 的 依赖 关系 定义 


Java 的 话 有 Apache Commons 系列 的 库 ， 脚 本 语言 的 话 有 ImageMagick ” 
和 Mechanize 等 ， 一 般 开 发 过 程 中 都 会 用 到 一 些 外 部 的 库 。 这 些 外 部 库 
的 依赖 关系 也 应 该 纳入 到 版 本 管理 系统 中 进行 适当 的 管理 。 


























G http:Wcommons.apache.org/ 
© http:/www.imagemagick.org/ 
3) http:/mechanize.rubyforge.org/ 
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3.5 使 用 Git 顺利 地 推进 并 行 开发 





这 里 我 们 来 看 一 下 通过 使 用 版 本 管理 系统 ， 在 团队 中 顺利 地 开展 并 
行 开 发 的 方法 。 

如 上 所 述 ，Git 提供 了 能 够 使 多 人 并 行 开 发 的 合并 模式 ， 因 此 能 方 
便 地 实现 多 人 同时 编辑 同一 文件 。 但 是 ， 当 一 个 人 不 得 不 并 行 地 进行 多 
个 不 同 的 开发 时 ， 束 会 有 一 些 问 题 。 

第 2 草 的 问题 2 和 问题 9 中 涉及 的 、 在 新 功能 的 开发 过 程 中 需要 
修改 已 发 布 版 本 中 的 bug 的 情况 下 ， 就 可 以 使 用 版 本 管理 系统 的 分 文 
功能 。 








3.5.1 分 支 的 用 法 


seeeeeeeseeeseeeseeseeeeeeeeseeseseseeeseseeeeeseeeeeeseeeeseeseeeseeseseseeeseeeeseeeeseeeeseeseeeseeeseeeseeeseeeseeeseeseeeeeeeeeeeee 


@…… 什么 是 分 支 


分 文 ( branch )， 瑞 语 的 意思 为 树 校 。 是 一 种 从 主干 分 离 出 来 的 ， 作 
为 和 主 开 发 内 容 不 同 的 开发 内 容 进 行 分 别管 理 的 机 制 。 分 文 是 几乎 所 有 
的 版 本 管理 系统 都 具备 的 标准 功能 。 

和 其 他 的 版 本 管理 系统 相 比 ，Git 的 分 支 功能 的 特点 是 速度 快 晶 易 
于 使 用 。 


和 什么 是 发 布 分 支 ( release branch ) 


以 第 2 草 的 情形 为 例 ， 我 们 来 看 一 下 分 文 的 使 用 方法 。 但 在 此 之 
前 ， 我 们 先 来 谈 一 下 发 布 分 文 的 用 法 。 

发 布 分 文 是 回 正 式 环境 进行 发 布 时 实际 使 用 的 分 文 。 有 将 master 用 
作 发 布 分 支 的 ， 也 有 从 master 建立 别 的 分 支 作 为 发 布 分 支 的 。 

具体 来 说 就 是 要 根据 各 团队 和 项 目的 实际 情况 选择 合适 的 方法 ， 没 
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有 一 定 正确 的 答案 。 关 于 使 用 Git 的 工作 流程 的 组 建 方式 ， 我 们 将 稍 后 
介绍 。 本 次 事例 中 暂且 以 master 作为 发 布 分 支 ， 下 面 的 讲解 都 是 以 此 为 
前 提 的 。 
@…… 克隆 和 建立 分 支 

首先 将 ( 所 认为 的 ) 中 央 代码 库 克 隆 到 本 地 机 器 上 。 


$ git clone git@github.com:CoolInc/someniceapp.git 


接 春 为 发 布 后 的 新 功能 开发 建立 分 文 。 分 文 的 名 称 驶 是 new-cool- 


function 。 











ScalecaEWC GTTCLEENRGI 


分 文 建立 之 后 进行 checkout 操作 。 这 里 的 checkout 和 以 Subversion 
为 代表 的 中 央 集 权 型 版 本 管理 系统 中 的 checkout 的 意思 是 不 同 的 ， 这 里 
使 用 checkout 命 令 来 进行 分 文 切换 。 
$ git checkout new-cool-function 
这 样 一 来 就 可 以 在 master 以 外 的 分 文 上 进行 新 功能 的 开发 ， 不 会 对 
已 经 发 布 的 代码 产生 任何 影响 。 








e…… 提交 和 提交 记录 


假设 已 经 修改 了 几 处 代码 ， 现 在 我 们 用 git commit 命 令 来 试 着 
进行 提交 。 


$ git commit -m "实现 了 非 弟 炫 的 功能 " 
$ git commit -m "修改 了 一 些小 错误 " 
$ git commit -m "想到 了 一 些 需要 改进 的 地 方 ， 于 是 进行 了 修改 " 


上 述 提交 记录 的 问题 在 于 内 容 过 于 抽象 ”， 但 我 们 这 里 暂且 先 继续 
下 去 。 
再 用 git 1og 命 令 来 确认 一 下 提交 记录 。 





@ 阅读 到 这 里 的 读者 一 定 知 道 这 种 写法 的 提交 记录 是 肯定 不 行 的 。 这 里 我 们 是 以 第 
2 章 的 案例 进行 说 明 ， 第 2 章 的 案例 中 也 正 是 因为 没有 正确 地 填写 提交 记录 ， 才 
导致 提交 记录 如 同上 述 提交 记录 一 样 让 人 无 法 理解 。 实 际 操作 中 应 该 将 修改 的 内 
容 写 入 提交 记录 。 关 于 这 部 分 内 容 我 们 在 第 4 章 会 进行 具体 的 讲解 。 另 外 ， 在 提 
交 记 录 中 记 下 相关 联 的 bug 票 号 也 是 非常 重要 的 。 
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Share 本 oasiaie2E SS 

05afd8b298d2439ddf7d5ae720b4967613fbllcb 实现 了 非常 炫 的 功能 

4006971346bocae1596914023981eff4a8b5410c 修改 了 一 些小 错误 

2487df32b6096cd349d8543304a299e41fdb037a 想到 了 一 些 需 要 改进 的 地 方 ， 于 是 
ji 和 了 修改 


还 可 以 用 git branch 命 令 来 确认 分 文 的 改变 


9 GitE Drancen 
master 
* new-cool-function 


至 此 ， 新 建 分 支 的 状态 如 图 3.2 所 示 。 
82 新 建 的 分 支 


























f 、 
27b0687 人 
05afd8b 4006971 2487df3 | new-cool- 
Dy | ed function 
: 想到 了 一 些 需 
实现 了 非常 修改 了 一 些 0 
炫 的 功能 小 错误 改进 的 地 方 ， 于 
pe 
- 区 











e…… 分 支 的 切换 


在 第 2 章 的 案例 中 ， 有 报告 称 已 经 发 布 的 正式 环境 中 发 生 了 故障 。 
如 果 按 照 第 2 草 的 死亡 行军 项 目的 做 法 ， 又 是 给 目录 重 命 名 又 是 复制 
文件 的 话 ， 那 就 实在 太 麻 烦 了。 其 实用 git checkout 命 令 就 能 简单 
处 理 。 


$ git checkout master 


只 需 执行 上 述 命 令 就 能 切换 回 master 分 文 ， i 
本 Me 是 否 已 经 回 到 master 分 文 ， 可 以 通过 git 1log 命 令 确 
认 下 提交 记录 。 


Seaueroo ene enemae 
27b06870957e44d5b02606af668c9al20df4b7e0 最 初 的 发 布 版 本 
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保险 起 见 ， 我 们 再 用 git branch 命 令 来 确认 下 。 


Senye lamel 
* master 


new-cool -function 


确实 已 经 回 到 了 master 分 文 。 这 里 假设 我 们 正 处 于 第 2 章 所 述 的 境 
况 下 ， 让 我 们 试 着 对 故障 进行 处 理 。 不 直接 修改 master， 而 是 新 建 故障 
处 理 用 的 分 支 ， 然 后 再 进行 提交 。Git 的 分 支 建 立 非 常 快速 昌 易 于 合并 ， 
因此 应 该 灵活 应 用 其 分 文 功能 。 


$ git checkout -b issue345 











Sen amel 


* 


ijssue345 
master 
new-cool -function 


可 以 使 用 git checkout -b XXX 命令 来 建立 分 文 并 同时 进行 
checkout 操作 。 分 支 的 名 字 可 以 任意 取 ， 这 次 假设 已 经 有 了 上 故障 报告 的 
bug 票 (ticket )， 以 票 号 为 名 字 建 立 分 支 。 缺陷 (ticket ) 管理 系统 
(ITS/BTS ) 的 相关 内 容 将 在 第 4 草 进 行 讲解 。 


@…… 修正 bug 后 的 提交 


在 issue345 分 文 上 对 bug 进行 了 修正 ， 并 进行 了 3 次 提交 ， 如 下 
所 示 。 


$ git commit -m "邮件 的 bug 修 正 " 
$ git commit -m "申请 时 的 死 锁 问题 的 修正 " 
Ss git commit mv 州 去 没 用 的 代码 ? 


在 issue345 上 提交 了 3 个 修正 后 ,分 支 的 状态 如 图 3.3 所 示 。 
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图 3.3 ”新 建 的 故障 处 理 用 的 分 支 


f 





Master 


| New-cool- 
05atd8b | 4006971] 2487df3 ee 


想到 了 一 些 需要 
0 
是 进行 了 修改 


ae9884e ad2d9a2 bdabe98| issue345 


申请 时 的 
死 锁 问 题 
的 修正 



























修改 了 一 些 
小 错误 


实现 了 非常 
炫 的 功能 














删 去 没 用 的 
代码 














es 合并 到 master 


修正 告 一 段落 后 ， 让 我 们 把 修改 的 内 容 合 并 到 master。 只 需 切 换 到 
master 并 执行 以 下 命令 即 可 。 


$ git checkout master 

$ git merge issue345 
Updating e380b5e..8f3b4e5 
Fast forward 


src/main/scala/Application.scala | 1 - 

src/main/scala/MailSender.scala | 1 + 

2 files changed, 13 insertions(+), 1 deletions(-) 
终 的 状态 如 图 3.4 所 示 。 


ed 影响 新 功能 开发 的 基础 上 ， 完 成 了 对 故障 的 处 理 *。 


Q) 实际 在 案例 分 析 中 数据 库 的 变更 管理 也 是 非常 琼 手 的 一 个 问题 ， 需 要 了 予以 解决 。 
但 这 里 暂且 不 进行 说 明 ， 数 据 库 变更 管理 的 相关 内 容 将 在 后 面 进行 讲解 。 
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图 3.4 合并 到 master 
让 、 





ae9884ePPPlad2d9a2 Plbdabe981 master 
new-cool|- 
(05afd8b (4006971 (2487df3 Pe 


想到 了 一 些 需要 
改进 的 地 方 ， 于 
是 进行 了 修改 






















修改 了 一 些 
小 错误 


实现 了 非常 
炫 的 功能 









申请 时 的 
死 锁 问题 
的 修正 














和 回 master 进行 Push 


接着 ， 把 本 地 机 器 上 合并 到 master 分 支 中 的 修正 用 git push 命 
令 Push 到 中 央 代 码 库 。 


$ git push origin master:master 
这 样 Push 驶 完 成 了 。 接 春 让 QA 部 门 进 行 验收 测试 ， 用 git 
checkout 命 令 就 能 回 到 原来 的 新 功能 开发 。 
Se eleelo Le new Yel nae 
之 后 ， 在 new-cool-function 分 文 上 进行 新 功能 深 加 的 开发 ， 开 发 完 
成 后 合并 到 master 即 可 “。 








〇 因为 本 次 的 例子 非常 简单 ， 所 以 能 够 轻易 地 合并 ， 但 也 有 发 生 冲 突 无 法 合并 的 时 
候 。 在 这 种 情况 下 ， 首 先 要 合理 地 解决 冲突 ， 然 后 再 重新 合并 。 这 和 Subversion 
等 其 他 的 版 本 管理 系统 的 思考 方式 是 一 样 的 。 
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e@…… 分 支 使 用 方法 总 结 


像 这 样 通过 合理 使 用 分 文 功能 ， 并 行 地 进行 多 个 版 本 的 开发 也 变 得 
容易 了 。 

Subversion 这 样 的 中 央 集 权 型 版 本 管理 系统 无 法 像 Git 这 样 简 单 地 
建立 分 文 。Git 的 话 还 可 以 在 本 地 机 融 的 封 财 环境 下 随意 地 建立 分 文 、 
进行 合并 ， 因 此 能 够 以 简单 旦 高 速 的 方法 实现 并 行 开发 。 





3.5.2 ”标签 的 使 用 方法 


seeeeeeseeeeseeseeeseseeseeseeeseseeeseeeseeeeseeseeeseeeeseeseeeseseeeseeseeseseeseeeseeseeeseeseeeeseeeeee 


@…… 什么 是 标签 

在 刚才 的 例子 中 ， 你 是 否 觉得 如 采 能 把 发 布 时 的 系统 快照 保存 下 来 
会 很 方便 呢 ? 标 签 ( tag ) 怠 是 用 于 实现 这 个 功能 的 。 实 现 的 细节 上 可 能 
有 所 差异 ,但 几乎 所 有 的 版 本 管理 系统 都 提供 了 标签 功能 。 





i 新 建 标 签 


还 是 刚才 的 例子 ， 首 和 完 可 以 为 发 布 的 时 间 点 打上 标签 。 下 面 就 以 
“v0.1" 为 标签 名 ,执行 git tag 命 令 。 标 签名 在 内 容 上 要 简洁 匈 懂 ， 
一 般 多 以 版 本 号 作为 标签 名 。 
otead v0 TT" 交 的 发 布 版 术 " 

这 样 以 后 也 能 找 出 这 个 时 间 点 的 系统 快照 了 。 

第 2 章 的 案例 分 析 中 ， 发 布 之 后 已 经 过 了 一 段 时 间 ， 这 样 的 情况 下 
仍然 可 以 追溯 回去 打上 标签 。 首 先 在 master 分 文 上 用 git 1log 命 令 寻 
找 对 应 的 提交 。 


$ git log --pretty=oneline 
27b06870957e44d5b02606af668c9a1l20df4b7e0 最 早 的 发 布 版 本 
ae9884e9fle7551026c447556c63db58d49d6774 邮件 的 bug 修 正 
ad2d9a217af750b2fb0a0636f0a26ef761ba2bfc 申请 时 的 死 锁 问题 的 修正 
bdabe98d3b9102ce33ed7b4c6033ebc9cbb44fe6 删 去 没 用 的 代码 











(D 关于 分 支 功能 请 参考 Pro Git 中 文 版 “Git 分 支 ” 一 章 (http://git.oschina.net/progit/3- 
Git- 分 支 .html) 或 者 nulab 提供 的 “猴子 都 能 懂 的 Git 入 门 ”( http://backlogtool. 
com/git-guide/cn/ ) 等 ， 上 述 资料 对 Git 的 分 支 功 能 做 了 浅显 易 懂 的 总 结 。 
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找到 对 应 的 提交 之 后 , 用 git tag 命 令 为 那个 提交 打上 标签 。 这 
样 就 OK 了 。 


$ git tag -a vO.1 27b06870957e44dq5b02606af668c9a120df4b7e0 


e…… 标签 的 确认 
下 面 来 确认 下 刚才 建立 的 标签 。 


Swe 
OL 


确认 了 标签 之 后 ， 青 来 确认 下 标签 对 应 的 内 容 是 否 正 确 。 


Some sow on 

learemviOrel 

Tagger: ikeike443 <ikeike443@gmail .com> 
Date: Mi Me LE lSs22859 3013 +0900 


Commit 27b06870957e44d5b02606af668c9al20df4b7e0 


Author: ikeike443 <ikeike443@gmail.com> 
Date: IO NE :ne 


最 早 的 发 布 版 本 


可 以 用 git ” show 命令 来 确认 标签 的 内 容 。 从 结果 来 看 内 容 似 乎 是 正 
确 的 。 在 本 地 环境 上 打 好 标签 后 ， 用 git push 命令 Push 到 中 央 代 码 库 。 


Skene ol OO 





e…… 标签 的 取得 


如 打 要 在 其 他 环境 上 取得 刚才 建立 的 标签 ， 应 该 怎么 做 呢 ? 

首先 ， 在 其 他 环境 上 用 git clone 命 令 进行 克隆 。 git clone， 
顾名思义 ， 就 是 克隆 代码 库 的 命令 。 代 码 库 中 包含 的 分 文 、 标 签 都 会 被 
复制 到 本 地 环境 中 。 


$ git clone git@github.com:CoolInc/someniceapp.git 
克隆 执行 完 后 建立 分 支 ， 并 将 标签 checkout 到 该 分 支 上 *。 


QQ 这 里 也 可 以 把 标签 名 和 分 支 名 都 设置 成 “v0.1”， 但 这 里 没有 这 么 做 。 相 关 原 因 请 
参考 专栏 。 
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Seneeeheekeou ee ono on 
这 样 就 能 在 其 他 环境 上 取得 标签 了 。 如 果 不 想 新 建 分 支 的 话 ， 还 可 
以 用 下 面 的 方法 “。 


Sneek eu on 


一 专栏 ”避免 使 用 相同 的 标签 名 和 分 支 名 


本 文 的 例子 中 虽然 避免 使 用 相同 的 分 支 名 和 标签 名 ， 但 使 用 相 
同 的 名 称 :也 是 可 以 的 。 


Senmeeeleel oe om Ol 


新 建 名 为 “v0.1” 的 分 支 ， 在 其 基础 上 checkout 名 为 “v0.1” 
的 标签 。 但 是 因为 同名 的 缘故 ,，“v0.1" 指 的 是 分 支 还 是 标签 就 不 清 
J 

这 里 ， 因 为 执行 的 时 候 还 没有 名 为 “v0.1” 的 分 支 ， 所 以 能 够 顺 
利 执行 。 如 果 已 经 存在 名 为 “v0.1” 分 支 ， 则 是 无 法 执行 的 。 例 如 ， 
如 果 之 后 再 新 建 名 为 “test” 的 分 支 ， 并 在 其 上 checkout “v0.1” 
标签 ， 就 会 出 现 以 下 消息 。 


Someoneekeoume osesia ON 
warning: refname 'v0.1' is ambiguous. 


fatal: Ambiguous object name: !V0.1'. 


相反 ， 在 从 master 切换 到 “v0.1” 分 支 时 也 会 出 现 同样 的 问题 。 


Senoheek ou oe 
warning: refname 'v0.1' is ambiguous. 
fatal: Ambiguous object name: !V0.1'. 


在 这 种 情况 下 ， 需 要 像 下 面 这 样 明确 指出 这 个 是 标 各 


//v0.1checkoeut 名 为 “v0 .1 ”的 标签 
$ git checkout -b test refs/tags/v0.1 


还 是 分 支 。 


]N0O TeneaeaaE 和 名 为 VO.1 的 分 支 
$ git checkout refs/heads/v0.1 


Git 中 ， 人 于 不 同 的 命名 空间 ， 因 此 通常 在 
使 用 时 不 需要 特别 指明 是 标签 I 可 以 省 略 。 所 以 说 ， SS 








Q) 这 样 操作 会 变 成 Detached HEAD 的 状态 。 相 关内 容 请 参考 专栏 。 
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看 标签 和 分 支 还 是 可 以 同名 的 。 
但 这 样 很 容易 造成 混乱 。 实 际 使 用 中 要 避免 标签 和 分 支 同 名 ， 
ae 万 一 出 现 同名 的 情 0 可 以 通过 指定 命 
空间 来 明确 是 标签 还 是 分 支 。 请 记 住 这 











人 标签 使 用 方 ; 法 总 结 


像 这 样 ， 通 过 用 标签 管理 系统 某 个 时 间 点 的 快照 ， 就 能 合理 地 进行 
版 本 管理 ， 在 发 生 故 障 后 查找 原因 时 ， 以 及 在 紧急 情况 下 的 系统 回 滚 
时 ， 也 能 发 挥 作用 。 

本 次 的 例子 中 ， 在 最 初 发 布 时 打 了 一 次 标签 。 之 后 处 理 故 障 ， 将 修 
改 合并 到 了 master， 因 此 待 QA 部 门 的 验收 测试 结束 ， 可 以 再 次 发 布 
时 ， 应 该 再 次 打上 标签 。 


$ git tag -a v0.1.1 -m "进行 了 issue 345 的 故障 处 理 " 


最 终 ， 合 理 使 用 分 支 和 标签 功能 之 后 ， 版 本 管理 系统 的 状态 如 图 
3.5 所 示 。 





图 3.5 ”活用 标签 


只 DS 


(ae9884e J>lad2d9a2 >lbdabe98)J master 
(05afd8b }»(4006971}»>(2487df3 tg 


UnctIon 




















信 攻 而 全 芷 
WN 


实现 了 非常 
炫 的 功能 











申请 时 的 
死 锁 问 题 
的 修正 


删 去 没 
代码 
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至 此 ， 我 们 一 起 看 了 使 用 分 文 和 标签 功能 的 基本 的 团队 开发 的 方 
法 。 下 一 市 我 们 将 研究 使 用 分 支 功能 的 团队 开发 工作 流程 的 各 种 形式 。 








一 专栏 什么 是 Detached HEAD 
执行 本 文中 的 命令 ， 会 显示 下 面 这 样 的 消息 


Sceneekeou on 


Nolesels: emeelk me rou Or 


You are in 'detached HEAD' state. You can look around, make experimental 
changes and commit them, and you can discard any commits you make in this 
state without impacting any branches by performing another checkout. 


If you want to create a new branch to retain commits you create, you may 
do so (now or later) by using -b with the checkout command again. Example: 


ememelheelkowmee omaneweeneh naame 


HEAD is now at 8a4e89c... XXXX 


这 就 是 Detached HEAD 状态 。 不 必 建 立 分 支 就 能 实验 性 地 修改 
并 提交 ， 或 者 放弃 修改 。 执 行 git branch 命 令 ， 显 示 如 下 。 


Sneha 
* (detached from vO.1) 
master 


如 果 最 终 想 保留 在 这 个 状态 下 进行 的 各 类 实验 性 质 的 提交 的 话 ， 
只 需 重 新 建立 分 支 ， 并 切换 到 该 分 支 上 ， 就 能 将 提交 保存 下 来 。 
$ git checkout -b new branch name 
是 很 方便 的 功能 ， 但 在 部 署 过 程 中 
获取 标签 的 时 候 ， 人 Detached HEAD 状态 ， 管 理 上 就 很 
难 理解 。 所 以 要 像 本 文中 的 示例 一 样 ， 一 开始 就 新 建 分 支 ， 并 将 其 
checkout。 但 具体 做 法 还 是 要 结合 项 目 自身 的 情况 进行 探讨 。 
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3.6 _ Git 的 开发 流程 





到 这 里 为 止 ， 我 们 一 起 了 解 了 分 布 式 版 本 管理 系统 所 具有 的 灵活 
性 ， 以 及 Git 的 分 支 、 合 并 、 标 签 功 能 的 便捷 和 高 速 。 

那么 ， 在 实际 使 用 Git 进行 团队 开发 的 过 程 中 ， 应 该 采用 怎样 的 开 
发 流程 呢 ? 

以 Subversion 为 代表 的 中 央 集 权 型 版 本 管理 系统 中 能 执行 的 项 目 并 
不 多 ， 所 以 开发 流程 也 自然 而 然 地 只 有 一 种 。 另 一 方面 ， 因 为 Git 过 于 
灵活 ， 所 以 容易 让 人 产生 困惑 ， 不 知道 应 该 采用 怎样 的 开发 流程 。 

老实 说 ，Git 开发 流程 现在 似乎 还 没有 固定 的 模式 。 原 因 之 一 是 Git 
不 仅 功能 丰富 而 且 非 常 灵 活 ， 即 便 不 规定 流程 也 还 是 能 正常 使 用 。 本 节 
将 介绍 比较 常用 的 Git 工作 流 的 模式 。 














3.6.1 Git 工作 流 的 模式 


Git 的 工作 流 大 致 有 如 下 几 种 模式 。 


e 中 央 集 权 型 工作 流 
e GitHub 型 工作 流 


e@…… 中 央 集 权 型 工作 流 


Pro Gi 中 也 举 过 这 样 的 例子 ， 即 像 以 前 的 Subversion 那样 设置 1 
个 中 央 代 码 库 ， 全 体 开 发 人 员 以 此 为 唯一 的 Push/Pull 对 象 ， 将 环境 克隆 
到 本 地 机 种 上 (图 3.6)。 





@ 该 书 第 2 版 将 由 人 民 邮 电 出 版 社 出 版 。 一 一 编者 注 
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图 3.6 ”中央 集权 型 工作 流 








ER 
yp 


本 | 

该 工作 流 的 优点 是 操作 和 和 Subversion 基本 相同 ， 思 考 方式 也 不 需要 
太 大 的 改变 。 男 外 ， 借 助 把 Subversion 的 代码 库 视 作 Git 来 进行 交互 的 
工具 git-svn， 实 际 的 中 央 代 码 库 可 以 仍然 是 Subversion。 当 现 有 的 代码 
库 是 Subversion， 并 且 移 植 到 Git 的 成 本 很 高 时 ， 这 种 情况 下 该 工具 是 
非常 有 效 的 。 


















e@…… GitHub 型 工作 流 


Pro Git 中 称 之 为 “整合 经 理 型 工作 流 ”。 因 为 该 流程 和 GitHub 的 机 
制 基 本 相同 ， 所 以 本 书 称 之 为 GitHub 型 工作 流 。 

GitHub 型 工作 流 同样 也 设置 1 个 代码 库 为 中 央 代 码 库 ， 但 开发 人 员 
会 各 自从 中 央 代 码 库 Fork 出 自己 的 远程 代码 库 ， 并 将 其 克隆 到 本 地 机 
从 上 。 

GitHub 型 工作 流 的 方式 是 ， 在 日 常 开 发 中 将 修改 Push 到 Fork 出 的 
自己 专用 的 远程 代码 库 上 ， 当 修改 相对 稳定 后 ， 请 中 央 代 码 库 的 管理 者 
进行 Pull 操作 (图 3.7 )。 

这 样 的 流程 基本 就 是 GitHub 的 流程 。 其 优点 在 于 不 需要 等 待 中 央 
代码 库 的 维护 或 合并 操作 ， 各 开发 人 员 能 够 并 行 地 进行 作业 。 开 发 人 员 
拥有 自己 独立 的 代码 库 ， 可 以 在 代码 库 之 间 自 由 地 相互 Push/Pull。 这 也 
可 以 说 是 只 有 分 布 式 版 本 管理 系统 才 具 备 的 优点 。 
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MO GitHub 型 工作 流 








厂 人 


中 央 代 码 库 各 开发 人 员 的 远程 代码 库 











\ > 

在 Git 的 系统 上 应 用 该 流程 时 ， 因 为 没有 任何 约束 ， 所 以 运用 中 不 
注意 的 话 容易 造成 混乱 。 如 末 想 利用 这 种 方式 ， 推 荐 使 用 提供 以 这 种 方 
式 调 整 后 的 工作 流 的 GitHub。 











ss 


在 已 经 设置 中 央 代 码 库 的 情况 下 ， 关 于 发 布 时 的 发 布 分 文 应 该 如 何 
处 理 、 开 发 时 是 否 要 建立 topic 分 文 、 修 正 bug 的 分 文 要 怎样 处 理 等 分 
支 运 用 的 策略 也 有 痢 各 种 各 样 的 模式 。 




















git-flow 是 2010 年 Vincent Driessen 在 “A successful Git branching 
model” 这 篇 博客 “中 提出 的 分 支 运 用 策略 。 同 时 也 指 为 了 支持 该 分 支 策 
上 略 而 编写 的 工具 。 

该 分 支 策略 在 分 布 式 版 本 管理 系统 的 工作 流 中 稍 许 引 入 了 中 央 集 权 





(DD) http:Wnvie.comy/posts/a-successful-git-branching-model/ 
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型 版 本 管理 系统 的 长 处 ， 可 以 说 是 结合 了 双方 优点 的 团队 开发 流程 。 通 
过 在 团队 内 部 统一 管理 建立 分 支 的 方法 、 合 并 的 做 法 以 及 关闭 分 文 的 方 
法 ， 来 实现 git-flow 分 支 委 上 略 。 

git-flow 提议 以 固定 的 模式 在 中 央 代 人 码 库 中 建立 两 个 主 分 文 ， 在 各 
开发 人 员 的 代码 库 中 建立 3 个 辅助 分 文 (图 3.8 )。 
图 3.8 git-flow 


pe NN 
Release 





Feature 


分 支 Develop Hotfixes master 









面向 下 一 次 
发 布 的 主要 | 〇 7 
| 功能 的 开发 


面向 正式 环境 的 
紧急 bug 修正 


















把 bug 修正 
合并 到 
Develop 中 | 











伍 芝 下 





一 次 发 布 ”是 指 
1.0 版 之 后 的 发 布 J 


从 发 布 分 支持 续 地 向 
Develop 分 支 合 并 bug 
修正 的 内 容 


"A successful Git branching model" by Vincent Driessen ( 引 自 
http:/nvie.comy/posts/a-successfulgitbranchingmodel/ ) 

















想 详 细 了 解 该 分 文清 略 的 读者 请 参考 上 述 博客 或 相关 资料 。 
图 3.8 中 的 各 个 分 支 的 含义 如 下 。 


@ 主 分 支 
在 中 央 代 码 库 和 从 中 央 代 码 库 克隆 的 各 开发 人 员 的 代码 库 中 一 直 存 在 的 
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主要 的 分 支 

O Master 
为 发 布 而 建 的 分 支 。 每 次 发 布 时 都 打上 标签 

O Develop 
开发 用 的 分 支 。 发 布 之 前 的 最 新 版 本 

e 辅助 分 支 
原则 上 只 存在 于 各 开发 人 员 的 代码 库 中 ， 是 发 挥 相 应 的 功能 后 就 被 删除 
的 临时 分 支 

oO feature 
从 develop 分 离 出 来 的 被 用 于 开发 特定 功能 的 分 支 。 功 能 开发 结束 后 被 
合并 到 develop 中 

O release 
从 develop 分 离 出 来 的 为 发 布 做 准备 的 分 支 。 在 发 布 的 准备 工作 期 间 ， 
为 了 避免 多 余 的 feature 混杂 到 发 布 中 而 建立 的 分 支 。 发 布 结束 后 被 合并 
到 master 和 develop 中 

O hotfix 
主要 是 在 发 布 后 的 产品 发 生 故 障 时 紧急 建立 的 分 支 。 直 接 从 master 分 
离 ，bug 修正 后 再 合并 到 master 并 打上 标签 。 为 了 避免 将 来 遗漏 这 个 
bug 的 修正 ， 还 要 合并 到 develop。 如 果 此 时 有 正在 发 布 作业 中 的 
release 分 支 ， 还 要 向 release 进行 合并 


这 样 的 分 文 策略 条 理 清晰 且 容 易 理 解 ， 能 够 立刻 投入 到 实际 运用 
中 。 为 了 支持 该 分 文 策略， 还 提供 有 Git 扩展 脚本 ( git-flow 脚本 )。 通 
过 使 用 脚本 ,运用 会 变 得 更 加 容易 。 

在 有 一 定数 量 的 人 员 的 开发 中 ， 按 照 git-flow 分 文生 略 这 样 整理 、 
运用 分 支 ， 管 理 也 会 变 得 简单 。 

问题 在 于 运用 有 些 复杂 ， 需 要 记忆 的 内 容 比 较 多 。 并 且 如 采 没 有 
git-flow 提供 的 git-flow 脚本 的 话 ， 运 用 会 比较 困难 。 特 别 是 在 使 用 GUI 
工具 的 情况 下 就 无 法 沾 到 git-flow 脚本 的 光 了 ， 这 点 需要 注意 ”。 




















Q) Atlassian 提供 的 SourceTree 工具 好 像 支持 git-flow 分 支 策略 。 
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@…… github-flow 


github-flow 是 由 Pro Gz 的 作者 兼 GitHub 长 官 Scott Chacon 在 博客 
中 发 表 的 GitHub 的 工作 流 。 

Scott Chacon 也 认为 git-flow 是 非常 出 色 的 ， 但 就 实际 运用 比较 复杂 
这 方面 ， 他 列举 了 如 下 问题 。 

问题 之 一 在 于 Git 本 号 就 绝 非 容易 理解 ， 此 外 还 必须 理解 分 文 
寅 略 。 

问题 之 二 在 于 使 用 GUI 工具 的 话 就 无 法 使 用 git-flow 脚本 ， 因 此 就 
不 得 不 目 己 充分 理解 分 文 策 略 。 何 况 难 以 理解 分 文 策 略 的 人 往往 也 无 法 
合理 使 用 git-flow 脚本 ， 这 样 的 人 最 终 就 无 法 合理 运用 git-flow。 

针对 上 述 问 题 ，GitHub 采用 了 下 面 这 些 更 为 俐 单 的 做 法 。 这 就 是 所 
谓 的 github-flow。 





e master 的 内 容 都 可 以 进行 发 布 

e 添加 内 容 时 直接 从 master 新 建 分 支 

e 建立 的 分 支 在 本 地 环境 上 提交 ， 并 以 同名 的 分 支 定期 向 远程 代码 
库 进 行 Push 

e 开发 结束 后 向 master 发 送 Pull Request 

e Pull Request 通过 review 之 后 合并 到 master， 并 从 master 向 正 
式 环境 发 布 


还 有 一 点 在 上 述 项 目 中 没有 提 到 ， 那 就 是 github-flow 是 以 使 用 
GitHub 进行 开发 为 前 提 的 “。 

从 博客 的 图 片 中 可 以 看 出 ，github-flow 没有 Fork 中 央 代 码 库 ， 而 是 
采用 了 代码 库 唯一 的 方式 (中央 集权 型 版 本 管理 系统 )。 

该 方式 的 特点 在 于 简单 、 易 于 理解 。 开 发 人 员 只 需要 记 住 以 下 3 点 
就 行 了 。 








e master 是 用 于 发 布 的 ， 不 要 直接 在 master 上 进行 修改 


JJ http://scottchacon.com/2011/08/31/github-flow.html 
© 为 是 github-flow， 所 以 这 也 是 理 所 应 当 的 。 
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e 开始 作业 时 要 先 建 立 分 支 
e 作业 结束 后 向 master 发 送 Pull Request” 


为 了 使 Pull Request 在 通过 review 之 后 能 立即 进行 合并 并 发 布 ， 在 
Pull Request 发 送 之 前 需要 在 本 地 进行 测试 ， 或 者 保持 使 用 Jenkins 等 CI 
工具 的 目 动 化 测试 一 直 运 行 ， 这 是 github-flow 的 前 提 。 

当 正 式 环境 出 现 故障 时 ， 也 只 需要 简单 地 从 master 建立 分 文 并 进行 
修正 ， 发 送 Pull Request 并 合并 ， 百 接 进 行 发 布 就 行 了 。 

像 GitHub 这 样 ， 通 过 保持 master 随时 都 能 发 布 来 简化 实际 的 运用 ， 
这 的 确 是 一 个 不 错 的 办 法 。GitHub 目 身 一 天 之 内 要 进行 儿 十 次 发 布 。 为 
了 实现 这 样 频 度 的 发 布 ， 就 必须 准备 好 CI 以 及 CD 的 环境 。 而 准备 这 
样 的 环境 是 比较 困难 的 。 





e@…… 笔者 的 例子 ( 折 囊 方案 ) 


git-flow 比较 倾 癌 于 发 布 间 隅 较 长 的 大 规模 项 目 ，github-fow 则 适用 
于 需要 时 党 发 布 的 具有 速度 感 的 项 目 ， 例 如 Web 服务 等 。 下 面 举 一 个 稍 
许 极 端的 例子 。 

笔者 所 属 的 团队 ， 因 为 git-flow 比较 复杂 所 以 没有 使 用 ， 实 际 运用 
的 是 定制 过 的 github-flow 形式 。 具 体 来 说 ,就 是 像 下 面 这 样 。 





e 以 使 用 GitHub 为 前 提 
e 采用 GitHub 形式 的 工作 流 ， 各 自在 GitHub 上 拥有 Fork 出 来 的 
远程 代码 库 。 
e 从 中 央 代 码 库 的 master 分 支 进行 发 布 
e 各 开发 人 员 可 以 在 自己 的 本 地 环境 和 远程 代码 库 上 随意 地 操作 
e 开发 结束 后 向 中 央 代 码 库 的 master 发 送 Pull Request 
e Pull Request 通过 review 后 合并 到 master 
e 在 发 布 准备 阶段 从 中 央 代 码 库 的 master 建立 发 布 分 支 
e 在 发 布 分 支 上 进行 回归 测试 、 部 署 测试 等 发 布 的 准备 工作 
DD Pull Request 不 仅 在 代码 库 之 间 ， 在 同一 代码 库 的 分 支 之 间 也 能 发 送 。 令 人 感到 
意外 的 是 不 知道 这 一 点 的 人 似乎 还 挺 多 的 。 
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e 在 进行 发 布 的 准备 工作 的 过 程 中 ， 开 发 人 员 仍 然 可 以 向 master 
发 送 新 功能 开发 的 Pull Request 
e@ 发 布 结 束 后 合并 到 master， 在 master 上 打上 标签 后 删除 发 布 分 支 


大 体 的 形式 是 只 对 中 央 代 人 码 库 的 master 和 发 布 分 文 进 行 严 格 管理 ， 
其 他 的 都 可 以 随意 Fork， 自 由 使 用 。 这 种 方式 下 的 权限 管理 也 变 得 相对 
简单 ， 只 需要 对 向 master 发 送 的 Pull Request 认真 地 进行 代码 review 及 
测试 ， 其 余 的 事情 就 不 用 考虑 了 ， 这 也 是 该 方式 的 优点 之 一 。 

正式 环境 发 生 故 障 时 的 处 理 流 程 是 : 先 将 发 布 时 打上 的 标签 
checkout 到 本 地 机 需 上 并 进行 修正 ， 修 正 后 向 中 央 代 码 库 的 master 发 送 
Pull Request， 合 并 Pull Request 后 建立 发 布 分 文 ， 发 布 结束 后 将 发 布 分 
支 合并 回 master 并 删除 。 虽 然 比 github-flow 步骤 稍微 多 了 一 些 ， 但 还 并 
不 是 太 复 灯 。 











3.6.3 ”最 合适 的 流程 和 分 支 策略 因 项 目 而 异 


本 市 我 们 了 解 了 使 用 Git 的 开发 流程 以 及 分 支 策略 。Git 系统 中 没有 
中 央 代 码 库 的 概念 ， 因 此 能 组 建 各 种 形态 的 工作 流程 。 这 样 的 灵活 性 正 
是 Git 的 魅力 所 在 ,但 过 度 的 目 由 事实 上 也 会 造成 很 多 麻烦 。 

接着 我 们 人 简单 地 看 了 具有 代表 性 的 流程 和 分 支 策略 。 还 介绍 了 笔者 
实际 运用 的 例子 。 具 体 运 用 方面 在 很 大 程度 上 会 受到 团队 的 商业 模式 的 
影响 。Web 服务 的 话 ， 只 需要 时 和 党 管理 好 最 新 版 本 和 已 经 发 布 的 版 本 这 
两 个 就 行 了 。 而 如 果 是 套装 软件 的 话 ， 就 必须 同时 维护 多 个 版 本 ， 所 以 
还 是 有 所 差异 的 。 

另外 ,在 发 布 分 文 和 开发 分 文 的 操作 方面 ， 如 采 该 产品 是 不 经 过 长 
时 间 的 回归 测试 就 不 能 发 布 的 产品 的 话 ， 还 是 将 发 布 分 文 和 开发 分 文 区 
分 开 来 进行 管理 比较 好 。 男 一 方面 ， 如 果 是 应 该 尽早 发 布 的 服务 的 话 ， 
则 可 以 说 像 github-flow 那样 ， 完 全 不 区 分 比较 好 。 

Git 的 开发 流程 能 够 很 灵活 地 定制 ， 所 以 请 大 家 一 定 要 结合 项 目的 
具体 情况 ， 试 着 思考 一 下 最 合适 的 流程 。 
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3.7 ”数据 库 模式 和 数据 的 管理 


3.7.1 需要 对 数据 库 模 式 进行 管理 的 原因 


团队 开发 中 ， 如 何 才能 有 效 地 管理 数据 库 模 式 “ 是 一 个 比较 环 手 的 
问题 “。 在 多 人 修改 数据 库 的 情况 下 ， 容 易 因 漏 执行 SQL 或 执行 顺序 出 
错 等 原因 造成 数据 库 的 数据 一 致 性 出 现 问题 。 

怎样 才能 解决 这 个 问题 呢 ? 由 于 该 问题 的 主要 原因 在 于 各 个 开发 人 
员 随 意 制 作 SQL 修改 数据 库 模式 ， 因 此 应 禁止 开发 人 员 修 改 数据 库 模 
式 ， 并 设置 数据 库 管 理 员 一 职 ， 由 此 人 对 所 有 的 修改 进行 管理 ， 这 样 是 
不 古 就 能 够 解决 问题 了 呢 ? 

过 去 采用 这 种 方式 的 开发 现场 比较 常见 ,但 从 以 下 这 些 原 因 可 以 看 
出 这 种 方式 是 存在 问题 的 。 


seeeeeeeseeeeseeeseeseeeeseeseeeeseeeeseseeseeee 

















e…… 由 数据 库 管理 员 负责 对 修改 进行 管理 的 情况 


首先 ， 在 由 数据 库 管 理 员 负 责 对 所 有 的 修改 进行 管理 的 情况 下 ， 如 
果 数 据 库 管理 员 成 为 瓶颈 的 话 ， 整 体 的 开发 速度 就 会 受到 影响 “。 














e…… 修改 共享 数据 库 的 模式 的 情况 


其 次 ， 如 宁 在 团队 中 共享 数据 库 ， 那 么 模式 的 变更 就 会 波及 到 整个 
团队 ， 影 响 开 发 进度 。 模 式 发 生变 更 时 ， 首 先 程序 的 代码 也 无 疑 会 发 生 
变化 ， 夯 修改 共 至 数据 库 的 模式 ,各 个 开发 成 员 的 代码 和 数据 库 模 式 就 
难 侈 会 发 生 背 离 。 因 此 可 以 说 对 数据 库 模 式 也 应 该 进行 版 本 管理 。 

















(DD 是 对 数据 库 构 造 的 定义 。 

@ 以 第 2 章 的 问题 4 为 例 。 

@) 根据 项 目的 规模 ， 设 置 数据 库 管理 员 也 是 必要 的 ， 因 为 有 数据 库 的 调整 或 备份 等 
本 来 应 该 由 数据 库 管 理 员 负责 的 业务 。 
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3.7.2 ”应 该 如 何 管理 数据 库 模 式 


对 数据 库 模 式 进 行 版 本 管理 ， 应 该 管理 什么 ?又 怎么 管理 呢 ? 让 我 
们 有 具体 地 来 看 一 下 。 这 里 假设 数据 库 为 MySQL 或 PostgreSQL 等 ， 也 就 
是 说 使 用 了 RDBMS， 以 此 为 前 提 来 继续 下 面 的 话题 。 但 是 这 里 的 数据 
库 并 不 局 限于 RDBMS， 文 本 文件 、XML 文件 、 对 象 数据 库 以 及 最 近 使 
用 频率 逐渐 增加 的 MongoDB 等 NoSQL 数据 库 ， 它 们 的 思考 方法 也 是 
完全 相同 的 。 








@…… 版 本 管理 的 必要 条 件 
对 数据 库 模式 进行 版 本 管理 的 必要 条 件 中 ， 比 较 重 要 的 是 以 下 3 个 。 





e 无 论 什 么 环境 都 能 用 相同 的 步 又 来 构建 数据 库 
e 能 够 反复 执行 多 次 
e 文本 文件 


上 面 这 些 也 是 和 CI 相关 联 的 思考 方法 。CI 相关 的 内 容 将 在 第 5 草 
进行 说 明 。 对 于 数据 库 模式 ， 和 代码 一 样 进行 版 本 管理 ， 无 论 任何 环境 
都 能 反复 构建 ， 这 一 点 是 非常 重要 的 。 另 外 ， 为 了 用 版 本 管理 系统 方便 
地 进行 合并 ， 以 文本 文件 的 形式 管理 模式 也 是 很 重要 的 。 

例如 有 的 开发 现场 使 用 商用 的 GUI 工具 来 建立 数据 库 模 式 ， 这 样 的 
工具 有 时 反而 会 影响 团队 开发 的 效率 。 因 此 一 定 要 以 程序 能 够 反复 执行 
的 文本 文件 形式 来 管理 数据 库 模 式 。 




















e…… 什么 是 数据 库 迁 移 


数据 库 模式 的 CI 称 为 CDBI ( Continuous DataBase Integration )。 
《持续 集成 : 软件 质量 改进 和 风险 降低 之 道 》 中 也 以 专门 的 章节 对 其 进 
行 了 说 明 。 但 是 最 近 比 起 CDBI,， 使 用 从 Ruby on Rails 的 工具 名 
( Migration ) 往生 而 来 的 “数据 迁移 ”这 个 叫 法 的 人 似乎 更 多 一 些 。 本 





QD) ( 美 ) Paul M. Duvall 、Steve Matyas、Andrew Glover 著 ， 王 海 鹏 译 ， 电 子 工 业 出 
版 社 ，2012 年 。 
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书 也 以 数据 迁移 这 个 用 语 来 继续 下 面 的 解说 。 
如 今 发 布 了 很 多 数据 迁移 用 的 工具 和 框架 ， 信 助 这 些 工 具 ， 能 比较 
简单 地 实现 数据 迁移 。 


@…… 数据 库 迁 移 的 功能 


如 前 所 述 ， 作 为 数据 库 迁 移 工 具 ，Ruby on Rails 的 Migration 是 比 
较 有 名 的 。 顺 便 说 一 下 ， 笔 者 所 在 的 公司 是 自己 开发 原生 的 工具 进行 数 
据 迁 移 的 。 的 确 ，Ruby on Rails 从 诞生 以 来 也 只 经 过 了 10 年 左右 的 时 
间 ， 还 算是 比较 新 的 架构 。 业 务 持续 了 10 年 以 上 的 公司 中 ， 独 自 开发 
工具 进行 数据 迁移 的 情况 还 是 比较 多 的 。 

不 同 的 工具 在 实现 的 细节 方面 有 细小 的 差异 ， 但 基本 的 构思 几乎 都 
是 相同 的 。 笔 者 所 在 的 公司 开发 的 工具 和 以 Ruby on Rails 的 Migration 
为 代表 的 工具 大 体 上 都 是 以 下 面 这 样 的 构思 来 制作 的 。 








e 管理 SQL 执行 的 顺序 和 需要 执行 哪些 SQL 
e 管理 模式 定义 编辑 的 冲突 

e 提供 回 滚 的 机 制 

e 文 持 数据 的 加 载 


SQL 的 模式 定义 (DDL，Data Definition Language ) 和 数据 加 载 
( DML，Data Manipulation Language ) 是 有 执行 顺序 的 。 如 同 我 们 在 第 2 
董 的 问题 4 中 所 见 到 的 那样 ， 执 行 顺序 发 生变 化 后 意义 也 会 随 之 改变 ， 
所 以 需要 对 执行 顺序 以 及 在 各 个 环境 中 需要 执行 哪些 SQL 进行 管理 。 
因此 大 部 分 工具 都 在 数据 库 中 建立 管理 表 ， 或 者 用 专门 的 XML 文件 来 
管理 执行 顺序 和 需要 执行 哪些 SQL 等 。 

为 了 避免 冲突 ， 通 常会 为 SQL 文件 确立 某 种 命名 规则 。 具 体 来 说 ， 
有 的 以 日 期 作为 文件 名 ， 将 相同 日 期 的 SQL 全 部 放 入 同一 文件 ;， 有 的 以 
连续 的 数字 作为 文件 名 ， 文 件 名 相同 的 话 则 进行 合并 等 。 

受 Ruby on Rails 的 Migration 的 影响 ， 如 今 的 工具 基本 都 提供 了 回 
深 的 机 制 。 制 作文 件 时 会 在 同一 文件 中 记载 回 深 用 的 SQL。CREATE 语 
句 对 应 DROP，INSERT 语句 对 应 DELETE， 这 样 执 行 用 的 SQL 和 回 滚 
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用 的 SQL 就 可 以 成 对 地 进行 管理 。 

数据 加 载 方面 和 模式 定义 相同 ， 比 较 多 的 工具 采用 在 文件 中 记载 
INSERT 或 UPDATE 的 方法 进行 管理 。 并 且 这 里 的 数据 主要 是 系统 初始 
化 设置 所 必需 的 数据 。 例 如 税率 的 数据 或 超级 用 户 的 数据 等 。 可 以 理解 
为 和 用 户 的 使 用 状况 无 关 ， 系 统 启动 时 所 必需 的 数据 。 

请 注意 这 里 加 载 的 数据 不 包括 单 体 测试 和 结合 测试 所 需要 的 数据 。 
测试 数据 不 属于 初始 化 数据 ， 而 属于 用 户 数 据 。 这 部 分 数据 应 该 通过 
Fixture 等 机 制 在 测试 程序 中 加 载 。 测 试 部 分 的 数据 管理 将 在 第 5 章 进 
行 说 明 。 














9 
接 下 来 将 对 主流 的 数据 库 迁 移 工 具 进行 说 明 。 在 因为 某 些 原因 无 法 
使 用 工具 的 情况 下 ， 可 以 考虑 上 自己 制作 符合 要 求 的 原生 工具 。 通 过 对 数 
据 库 模式 实行 版 本 管理 ， 项 目的 品质 和 速度 将 会 有 罕 破 性 的 飞跃 。 




















3.7.3 数据 库 迁 移 工具 


现在 已 经 出 现 了 各 种 各 样 的 数据 库 迁 移 工 具 ， 并 且 几 乎 所 有 最 近 的 
Web 应 用 程序 框 染 中 都 自 融 数据 库 迁 移 工 具 。Web 应 用 程序 框架 自 带 的 
| 


eeeeseeeeeseeeeeeeseeseseeseeeeseeseeeeeseseeeseseeeseeseeseeseeeeeeeseeseeeeseeseeeseeseeseeeseeeeseeeeeeseeeseeseeeeeeee 





@… Migration ( Ruby on Rails ) 


现在 Web 应 用 程序 框架 的 先驱 Ruby on Rails 自 带 的 工具 。 其 他 的 
工具 几乎 都 受 它 的 影响 。 为 了 管理 SQL， 会 在 数据 库 中 建立 名 为 
system setting 的 表 。 








@…… south ( Django ) 


比较 有 名 的 Python 框架 Django 中 自 带 的 名 为 south 的 工具 。 


QD) 将 测试 所 需要 的 数据 预先 加 载 到 数据 库 中 的 机 制 。 为 了 能 够 反复 测试 ， 通 常 
Fixture 会 在 执行 测试 前 加 载 数据 ， 在 测试 结束 后 删除 数据 。 像 这 样 预先 提供 数据 
加 载 和 删除 这 两 个 功能 的 情况 是 比较 多 见 的 。 
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e@…… Migrations Plugin ( CakePHP ) 
PHP 的 框架 CakePHP 中 为 了 进行 数据 迁移 而 提供 的 插件 。 
@…… Evolution ( Play Framework ) 


Java 和 Scala 的 框架 Play Framework 中 作为 标准 目 市 的 名 为 
Evolution 的 工具 。 
信人 多 
也 有 不 局 限于 特定 的 Web 应 用 程序 框架 的 通用 迁移 工具 。 这 类 工具 
的 数量 比较 多 ， 我 们 这 里 只 介绍 一 小 部 分 能 够 用 Java 调用 的 工具 。 








e@ Flyway” 
e@ Liquibase 
e dbdeploy” 


每 个 工具 的 功能 都 差不多 ， 所 以 选择 与 项 目 相 适应 的 ， 可 以 使 用 的 
工具 就 行 了 。 

如 果 要 在 已 有 的 应 用 程序 中 导 和 迁移 工具 ， 那 么 使 用 不 依赖 于 框架 
的 工具 会 比较 好 。 还 有 一 些 Java 的 项 目 ， 只 是 为 了 使 用 Migration 而 特 
地 导入 Ruby on Railgs， 这 么 做 的 开发 现场 也 是 有 的 。 











3.7.4 具体 用 法 ( Evolution ) 





关于 数据 迁移 工具 的 用 法 ， 这 里 以 笔者 作为 提交 者 ( committer ) 的 
Play Framework 为 例 来 进行 说 明 。Evolution 和 老大 哥 Migration 比 起 来 
功能 上 要 简单 很 多 ,但 必要 的 功能 都 有 了 。 














Evolution 和 其 他 类 似 的 工具 一 样 ， 对 于 文件 名 、 记 载 的 内 容 、 存 放 


(DD http://f{lywaydb.org/ 
© http:/www.liquibase.org/ 
(3) http://dbdeploy.com/ 
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的 目录 等 禾 有 规定 。 


e SQL 文件 以 1.sql、2.sql 这 样 连续 的 数字 命名 
e 一 定 要 放 在 程序 的 conf/evolutions/{ 数据 库 名 } 的 目录 下 
e SQL 文件 中 必须 要 有 Ups 和 Downs "这 两 部 分 的 定义 


例如 像 下 面 这 样 定 义 1.sql 文件 >。 


# User 表 
# --- !Ups 


CREATE TABEE User 
id bigint (20) NOT NULL AUTO INCREMENT., 
email varchar(255) NOT NULL, 
password varchar (255) NOT NULL, 
name varchar (255) NOT NULL, 
creat at date NOL. 
weeaerenmaeoaremN ey 
PRIMARY KEY (1d) 
) 


# --- !Downs 


DROBPOIABmE Ser, 


e@…… SQL 文件 的 执行 


Play Framework 在 存在 SQL 文件 的 状态 下 启动 程序 就 会 自动 执行 
Evolution 的 处 理 ”。 处 理会 对 比 本 地 机 器 上 的 数据 库 和 Evolution 的 SQL 
文件 ， 如 末 发 现 有 没有 被 执行 的 SQL， 就 会 在 浏览 杭 中 显示 如 图 3.9 这 
样 的 消息 ， 提 示 执 行 SQL。 


(D Ups 部 分 记载 需要 执行 的 SQL 的 定义 ,与 之 相对 ，Downs 部 分 记载 的 是 将 Ups 
部 分 的 内 容 回 深 时 需要 执行 的 SQL。 如 果 Ups 部 分 是 Create 的 话 ，Downs 部 分 
就 是 Drop， 大 致 就 是 这 个 样子 。 详 细 的 处 理 稍 后 进行 讲解 ， 大 概 机 制 是 当 版 本 管 
理 系统 中 的 SQL 和 实际 的 数据 库 状 态 之 间 的 一 致 性 出 现 问题 时 ， 就 运行 Downs 
部 分 的 内 容 进行 回 滚 。 

QQ Ruby on Rails 的 情况 下 不 是 SQL 文件 ， 而 是 用 Ruby 写 的 单独 的 DSL 文件 。 

(3) 当然 也 可 以 设置 为 不 自动 执行 。 
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图 3.9 有 SQL; 2 了 时 的 画面 ( Play i 


"2D 


世 Ko ~ 





"En 2 a ~ a es vw 地 从 
Database 'default neer TR = 证 Ly < 2 Se 和 - 


pA [9 localhost:9000 


Database "defauLt ”needs AIT 


ipt will be run on your database Apply this script now! 


This SQL script must be run: 


# 1!11! WARNING! This script contains DOWNS evolutions that are likely destructives 


# --- Rev:1,Downs - egb80b4 
DROP TABLE User; 


# --- Rev:1,Ups - 006208e 
CREATE TABLE User ( 
id bigintC20) NOT NULL AUTO_INCREMENT, 


GD oo Nm hh 机 六 pp 


email varchar(255) NOT NULL ， 


户 
© 


password varchar(255) NOT NULL, 


— 
> 


name varchar(255) NOT NULL, 


[= 
N 


creat_at date NULL, 


[= 
Ww 


update_at date NULL, 
PRIMARY KEY (Cid) 
); 


Pp 
un op 











按 下 “Apply this Script now!” 就 会 执行 SQL 文件 。 关 于 这 方面 ， 
Ruby on Rails 的 Migration 采用 的 是 命令 行 操 作 模 式 ，Play Framework 
采用 的 是 对 话 模式 “。 交 互 模式 虽然 不 同 ， 但 想 要 处 理 的 内 容 是 相同 的 。 











Oe 开发 者 之 间 数 据 库 模 式 的 同步 
假设 开发 人 员 A 为 添加 表 而 新 建 了 2.sql 文件 。 


HCGompany RWIl 


# --- !Ups 

CREATE TABLE Company ( 
id bigint (20) NOT NULL AUTO INCREMENT., 
name varchar (255) NOT NULL, 
ocean .area ES NOR NUIDG 
description text NOT NULL, 
url varchar (255) NOT NULL, 


Q) 最 新 的 Ver2 只 能 使 用 对 话 模式 进行 处 理 。Verl 也 可 以 用 命令 行 模式 进行 操作 。 
希望 Ver2 的 Evolution 也 能 早日 支持 命令 行 模式 。 
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Great at cate NYU, 
weeerenmeeearenN my 


PRIMARY KEY (id) 
) 3 


# --- !Downs 
DROPNEABEENComeemy 


在 A 的 数据 库 中 执行 该 SQL。 
这 时 开发 人 员 B 正好 想 给 1.sql 中 建立 的 User 表 增 加 一 列 。 因 为 不 
知道 A 已 经 建立 了 2.sqgl， 所 以 B 在 本 地 机 器 上 又 建立 了 2.sql。 





# User 修改 


# --- !Ups 


ZA Aa WEE DD Eee INMES 


# --- !Downs 


A AE UUSEE DROB dO 


开发 结束 后 ，B 向 中 央 代 码 库 Push 新 建 的 文件 。 之 后 A 也 进行 
Push， 但 因为 B 提交 的 2.sql 已 经 存在 ， 所 以 结 采 产生 冲突 了 。 


<<<<<<< HEAD 
¢¥ Gompany 大 加 


# --- !Ups 
CREATE TABLE Company 


( 


id bigint (20) NOT NULL AUTO INCREMENT., 


name varchar (255) 


IN(ONiE NI 


location varchar (255) NOT NULL, 


description text 
wale one 


NO No 
NO No 


creat ac darce No. 
game 本 al oaias NU 


PRIMARY KEY (id) 
) 5 


# --- !Downs 
DROPRIEANETENGEomeamy 3 


# Update User 


Hs 
ALTER TABLE User ADD 


# --- !Downs 


age TNT 
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ALTER TABLE User DROP age; 


>>>>>>> devB 


合并 后 的 代码 如 下 所 示 。 


# Company 术 加 





# --- !Ups 
ALTER TABLE User ADD age INT; 


CREATE TABLE Company ( 
id bigint (20) NOT NULL AUTO INCREMENT., 
name varchar (255) NOT NULL, 
location varchar (255) NOT NULL, 
description text NOT NULL, 
url varchar (255) NOT NULL, 
creat at cate NO, 
wpegereneeearenNey 
PRIMARY KEY (id) 

) 5 


# --- !Downs 
USSG DROP oes 


BROPIMIEABEENCOmMoemy 


合并 后 新 的 2.sql 和 执行 了 旧 的 2.sql 的 开发 人 员 A 的 数据 库 之 间 已 
经 有 了 差异 。Evolution 会 检查 出 该 差异 ， 回 深 卸 旧 的 数据 库 模 式 ， 并 重 
新 建立 新 的 模式 。 回 滚 处 理 时 会 用 到 Downs 部 分 ， 回 深 到 执行 2.sql 之 
前 的 状态 后 ， 再 重新 执行 Ups 部 分 。 在 此 之 后 ， 如 末了 B 进行 Pull，B 的 
数据 库 也 会 被 回 深 ， 然 后 被 重新 建立 。 

这 样 ， 多 人 各 目 持 有 的 数据 库 模 式 就 都 得 到 了 同步 。 




















e@…… 一 致 性 问题 的 管理 

由 于 某 些 原因 ， 执 行 SQL 也 会 有 失败 的 时 候 。 例 如 合并 SQL 时 出 
现 问 题 ， 生 成 了 自 相 了 矛盾 的 SQL， 并 且 没 有 注意 就 执行 了 该 SQL。 这 时 
Evolution 会 检测 出 错误 ， 作 为 模式 不 一 致 的 状态 进行 管理 ( 图 3.10 )。 
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94 | 第 3 章 版 本 管理 
3.10 ”一 致 性 问题 的 管理 ( Play Framework ) 


Database 'default' is in BR et 2 民 六 3 a RE 起 A ] 


(| | localhost:9000/@evolutions/apply/default?redirect=http%3A%2F%2Flocalhost%3A9000... Em 国 We tt 


Database ‘default'" 1s in inconsistent 


statel! 


An evolution has not been applied properl) 演 
manuaLLy before marking it as resolved - | 


Please check the problem and resolve it 


We got the following error: 列 名 "EMAIL” 必 重复 LTl\ 束 才 Duplicate column name "EMAIL"; SQL 
statement: CREATE TABLE User ( id bigint(20) NOT NULL AUTO_INCREMENT, email varchar(255) 
NOT NULL, password varchar(255) NOT NULL, name varchar(255) NOT NULL, email varchar(255) 
NOT NULL, creat_at date NULL, update_at date NULL, PRIMARY KEY (id) ) [42121-168] 
[ERROR:42121, SQLSTATE:42S21], while trying to run this SQL script: 





# --- Rev:1,Ups - e0b80b4 


CREATE TABLE User ( 

id bigintC20) NOT NULL AUTO_INCREMENT, 
email varchar(255) NOT NULL, 

password varchar(255) NOT NULL, 

name varchar(255) NOT NULL, 

email varchar(255) NOT NULL, 


WD 0 < DO A Rs 


PB» 
N pp © 


creat_at date NULL, 
update_at date NULL, 
PRIMARY KEY (id) 

); 








显示 上 述 画 面 时 ， 可 以 通过 手动 执行 SQL 进行 修正 后 再 按 下 Mark 
it resolved 按 键 ,或 者 修改 原 有 的 SQL 文件 后 再 运行 Evolution 的 
2 

这 样 ， 
成 为 了 可 能 。 





通过 对 SQL 的 错误 进行 管理 ， 使 得 管理 正确 的 数据 库 模 式 


3.7.5 ”数据 库 迁 移 中 的 注意 点 


对 数据 库 迁 移 文 件 (Evolution 的 话 是 SQL 文件 ，Migration 的 话 是 
Ruby 文件 ) 进行 版 本 管理 时 ， 判 断 合 并 的 结果 是 否 正确 是 一 个 比较 伤 
脑筋 的 问题 。 

RDBMS 的 数据 库 构建 可 以 说 只 要 不 出 现 错误 就 应 该 没什么 问题 ， 
但 无 法 保证 合并 后 的 SQL 一 定 正 确 ， 因 此 需要 对 数据 库 模 式 的 正确 性 
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进行 测试 。 

这 个 和 代码 的 合并 道理 相同 。 代 码 也 是 合并 后 的 文件 只 要 能 通过 编 
译 就 基本 可 以 说 没 问 题 了 ,但 从 程序 的 角度 来 看 ， 正 确 与 否 还 要 经 过 洲 
试 才 知 道 。 

只 要 使 用 数据 库 迁 移 ， 数 据 库 的 变更 管理 就 万 无 一 失 ， 这 样 的 说 法 
过 于 草率 ， 测 试 还 是 必须 的 ， 这 一 点 请 注意 。 应 该 编写 测试 程序 ， 做 到 
随时 都 能 够 自动 进行 测试 。 因 此 应 该 将 数据 库 迁 移 作 为 CI 的 一 个 环节 ， 
纳入 到 CI 之 中 。CI 的 相关 内 容 将 在 第 5 章 进 行 说 明 。 








人 
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3.8 配置 文件 的 管理 


如 同 我 们 在 第 2 章 的 问题 10 中 见 到 的 那样 ， 由 于 环境 不 同 ， 对 依 
赖 环境 的 各 种 配置 文件 也 要 进行 版 本 管理 。 首 和 完 ， 程序 方 面 的 配置 应 该 
把 每 个 环境 的 配置 文件 分 开 进 行 管理 。 例 如 数据 库 或 memcached 等 中 间 
件 的 连接 地 址 配置 “或 程序 本 身 固 有 的 配置 等 。 现 代 的 Web 程序 框架 一 
般 都 会 提供 这 样 的 机 制 ， 请 直接 使 用 。 即 便 出 错 了 ， 也 不 要 采用 手动 蔡 
换 staging 环境 或 正式 环境 中 的 配置 文件 这 样 的 方式 。 

将 所 有 资源 都 置 于 版 本 管理 系统 之 下 ， 只 使 用 版 本 管理 系统 中 的 文 
件 ， 任 何人 都 可 以 随时 目 动 化 地 执行 程序 的 构建 到 局 动 的 所 有 过 程 ， 只 
有 这 样 才能 维持 优质 、 快 速 的 开发 。 

接着 是 Apache、MongoDB 、memcached、PostgreSQL 等 中 间 件 自 
匡 的 配置 文件 的 管理 。 这 些 中 间 件 基本 上 都 没有 根据 不 同 的 环境 分 别 进 
行 配置 的 功能 。 因 此 大 多 数 的 公司 都 独立 开发 构 贷 服务 硕 用 的 安 闻 脚 
本 ， 或 者 在 目录 结构 和 符号 链接 方面 下 功夫 ， 以 尽 可 能 地 把 中 间 件 的 安 
效 到 配置 的 过 程 向 单 化 。 

通 销 部 署 程序 的 服务 需 由 多 人 台 组 成 ， 如 宁 不 能 有 效 地 管理 配置 文 
件 ， 要 进行 快速 的 发 布 是 不 可 能 的 。 现 在 用 于 解决 上 述 问题 的 工具 有 
Chef、Puppet、Capistrano 、Fabric、ServerSpec 等 。 使 用 这 些 工 具 的 管 
理 方 法 将 在 第 6 章 进 行 说 明 。 





























QD 以 数据 库 为 代表 的 中 间 件 的 连接 信息 中 一 般 会 包括 密码 。 将 密码 这 样 的 信息 直接 
提交 到 版 本 管理 系统 的 代码 库 可 能 会 产生 安全 方面 的 问题 ， 这 点 需要 注意 。 通 常 
只 将 开发 环境 的 密码 提交 到 版 本 管理 系统 ， 不 提交 staging 环境 或 正式 环境 的 密 
码 ， 而 使 用 部 署 脚本 在 每 次 发 布 时 进行 密码 设置 。 
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3.9 依赖 关系 的 管理 








开发 具有 一 定 规模 的 程序 时 ， 难 以 避免 地 会 使 用 到 一 些 库 。 程 序 所 
依赖 的 库 的 依赖 关系 的 定义 也 应 该 作为 版 本 管理 的 对 象 。 


3.9.1 依赖 关系 管理 系统 


现在 各 开发 语言 一 般 部 会 提供 以 下 3 点 的 组 合 。 


seeeeeseeeseeeeeeeeeseeeeeeeeseseeeeseseeseeseeeeeeseeeseeeseeeseeeseseeeseeseeeeeseeeseeeseeeseeeeeeseeeseeee 





e 管理 通用 库 的 仓库 
e 定义 对 库 的 依赖 关系 的 文件 
e 使 用 上 述 文件 实际 管理 依赖 关系 的 脚本 





下 面 列举 各 开发 语言 提供 的 一 些 主 要 工具 。 
@.… JVM 语言 


为 了 管理 Java 或 Scala 等 在 JVM 上 运行 的 语言 的 依赖 关系 ， 有 着 
各 种 各 样 的 工具 。 


e Apache Ant” ( +Apache ivy” ) 
e@ Maven” 

® sbt" 

e Gradle™ 


http://ant.apache.org/ 
https://ant.apache.org/ivy/ 
http://maven.apache.org/ 
http://www.scala-sbt.org/ 


四 昌国 昌 日 


http://www.gradle.org/ 
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这 些 工 具 都 参照 下 面 Maven 的 仓库 作为 共通 的 仓库 。 


e Maven 中 央 仓 库 * 
e Sonatype ( 中 央 仓 库 镜 像 ) ” 


如 果 制 作 了 可 以 作为 OSS 公开 的 通用 库 的 话 ， 只 要 上 传 到 上 述 仓 
库 ， 怠 能 在 全 世界 范围 内 共 孚 。 

还 可 以 在 公司 内 部 构建 Maven 的 仓库 。 只 想 在 公司 内 部 共享 的 库 
等 ， 可 以 上 传 到 公司 内 部 的 Maven 仓库 中 进行 管理 。 








和 脚本 语言 
每 个 脚本 语言 都 有 自己 各 式 各 样 的 依赖 关系 的 管理 工具 。 














e CPAN® ( Perl ) 

e PyP| ( Python ) 

e RubyGems”( Ruby ) 
e npm" (Node.js) 


和 JVM 语言 不 同 ， 脚 本 语言 的 仓库 和 工具 是 相同 的 。 这 是 因为 脚 
本 语言 较 早 地 采用 了 包 (package ) 管理 的 思考 方式 ， 并 一 直 在 进行 整 
理 。 男 一 方面 ，JVM 语言 因为 长 时 间 没 有 采用 这 种 思考 方式 ， 所 以 各 类 
工具 显得 有 点 混乱 。 
@…… 管理 依赖 关系 的 优点 


例如 Maven 中 的 依赖 关系 可 以 像 下 面 这 样 定义 。 


<dependencies> 








<dependency> 


http://search.maven.org 
https:/oss.Sonatype.org 
http://www.cpan.org/ 
https://pypi.python.org/pypi 
http://rubygems.org/ 


OOOOOOO 


https:/npmjs.org/ 
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en ew ne en oe 
<arElifacGtId>]yanl</artifact rds 
<version>1.3</version> 

</dependency> 

<dependency> 
ea /en 
<artifactId>junit</artifactId> 
<version>4.11</version> 

</dependency> 

</dependencies> 


这 样 定 义 后 ，Maven 会 自动 地 从 仓库 中 找 出 jyaml 和 junit， 并 将 其 
加 到 ClassPath 中 。 如 果 只 是 处 理 这 些 的 话 ， 你 可 能 会 党 得 这 和 在 网 上 
查找 库 并 手动 下 载 ， 然 后 再 添加 到 ClassPath 没什么 区 别 。 事 实 上 并 非 
如 此 。 

不 仅 是 Maven， 上 述 列举 的 各 个 工具 都 还 能 够 管理 传递 依赖 。 具 体 
来 说 ， 如 有 果 jyaml 和 junit 上 自身 有 依赖 的 库 的 话 ， 就 会 对 其 进行 查找 ， 找 
到 的 库 如 果 还 依赖 其 他 的 库 ， 则 继续 查找 下 去 。 也 就 是 说 ， 这 些 工 具 具 
有 上 自动 管理 所 有 传递 的 依赖 天 系 的 机 制 。 

这 样 ， 依 赖 关 系 也 能 作为 可 以 重复 执行 的 内 容 被 纳入 到 版 本 管理 的 
对 象 之 中 了 。 如 采 手 动 操作 的 话 ， 不 仪容 易 遗 漏 库 ， 再 加 上 环境 差异 等 
原因 ， 也 非常 厂 烦 。 因 此 在 开发 现场 依赖 管理 工具 是 必 不 可 少 的 。 

上 面 以 Maven 为 例 进行 了 了 说明。 其 实 CPAN 也 好 ，RubyGems 也 
好 ， 基 本 的 思考 方式 都 是 一 样 的 。 在 接 下 来 的 开发 中 ， 让 我 们 一 起 使 用 
依赖 管理 系统 进行 有 效 地 管理 吧 “。 

















@ 各 个 工具 的 详细 用 法 在 Web 上 有 很 多 相关 的 信息 可 供 参考 。 
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3.10 本章 总 结 





至 此 我 们 一 起 确认 了 什么 是 版 本 管理 系统 ， 一 边 回 顾 版 本 管理 系统 
的 历史 ， 一边 介绍 了 如 今 的 开发 现场 所 面临 的 问题 。 还 了 解 了 分 布 式 版 
本 管理 系统 的 使 用 方法 、 版 本 管理 系统 应 该 管理 的 内 容 以 及 有 效 的 管理 
万 5 

ee 谁 、 进 行 了 怎样 的 修改 ， 任 何 时 候 都 
可 以 进行 退 香 。 并 且 还 能 够 做 到 根据 需要 回 深 到 过 去 东 一 时 刻 、 多 乒 本 
IT Www 

但 是 只 有 版 本 管理 系统 的 话 还 是 不 知道 为 什么 要 进行 这 样 的 修改 ， 
解决 这 个 问题 就 需要 用 到 缺陷 管理 系统 。 

在 接 下 来 的 第 4 曹 ， 我 们 将 一 起 看 一 下 缺陷 管理 系统 的 有 效用 法 ， 
特别 是 和 版 本 管理 系统 联动 的 方法 。 
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4.1 缺陷 管理 系统 


4.1.1 项 目 进展 不 顺利 的 原 





如 果 参 加 项 目的 多 名 成 员 同 时 还 兼任 其 他 工作 ， 那 么 在 推进 项 目的 
过 程 中 重要 的 就 是 任务 整理 、 进 度 管理 和 信息 共 人 至 。 

项 目 成 功 / 失 败 的 形式 各 种 各 样 ， 并 且 不 同 的 项 目 和 团队 对 于 成 功 / 
失败 的 定义 也 各 不 相同 。 并 不 是 完成 了 所 有 的 任务 就 是 成 功 。 例 如 ， 即 
使 所 有 的 任务 都 按时 完成 了 ， 但 如 采 最 终 没 有 到 达 当 初 制定 的 目标 ， 不 
也 可 以 称 之 为 失败 吗 ? 

话 虽 如 此 ,项 目 能 够 进展 到 可 以 评判 成 功 / 失 败 的 阶段 可 以 说 还 算 
不 错 的 了 。 在 这 之 前 ， 有 的 项 目 就 已 经 出 现 “ 进 展 不 顺利 、 结 束 不 了 ” 
的 情况 了。 笔者 有 过 很 多 这 样 的 经 历 ， 相 信 读 者 也 有 类 似 的 记忆 吧 。 

项 目 “ 进 展 不 顺利 、 绪 束 不 了 ”的 原因 各 种 各 样 ， 大 致 有 下 面 这 些 。 














e 目标 错误 

e 估计 错误 ， 时 间 过 紧 ， 人 员 不 足 
e 没有 定义 项 目的 结束 

e 成 员 的 积极 性 不 足 ， 进 度 停滞 不 前 


从 笔者 的 经 验 来 看 ,“ 进 展 不 顺利 、 结 束 不 了 ”的 项 目 有 着 以 下 这 





。 项 目 无 法 可 视 化 
。 没 有 进行 任务 整理 、 进 度 管理 和 信息 共享 等 


换言之 ， 这 样 的 项 目 多 数 都 没有 做 到 “必须 要 做 什么 ”这 样 的 任务 


定义 、 由 “ 谁 ” 在 “什么 时 候 完成 ”这 样 的 责任 人 和 期 限 的 管理 、“ 以 
什么 作为 结束 ”这 样 的 任务 完成 的 定义 ， 以 及 “现在 正在 作业 中 还 是 已 
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经 完成 了 ”这 样 的 进度 管理 。 

但 是 不 进行 任务 管理 的 项 目 真 的 存在 吗 ? 毕 竞 笔者 还 没有 听 说 过 这 
样 的 事情 ， 无 论 哪 个 现场 都 应 该 以 茶 种 形式 对 任务 进行 管理 。 那 为 什么 
还 会 有 进展 不 顺利 的 项 目 呢 ? 这 可 能 是 因为 管理 方法 的 问题 。 








4.1.2 ”用 纸 、 邮 件 、Excel 进行 任务 管理 时 的 问题 


最 近 ， 随 着 缺陷 管理 系统 的 导 和 人 ， 像 第 2 革 问 题 1 那样 用 邮件 管理 
全 部 内 容 的 开发 现场 已 经 越 来 越 少 了 。 

即便 如 此 ， 不 使 用 缺陷 管理 系统 也 能 够 实现 任务 管理 、 进 度 管理 和 
言 息 共 享 。 年 轻 的 读者 之 中 可 能 有 人 不 知道 ， 在 过 去 的 开发 现场 ， 进 度 
管理 是 用 名 为 “bug 票 "” “问题 管理 表 ” 这 样 纸 质 的 管理 票 和 账本 来 进行 
的 。 还 有 的 开发 现场 用 Excel 制作 问题 管理 表 来 进行 管理 。 如 采 是 小 规 
模 的 开发 现场 ， 用 邮件 进行 任务 管理 也 不 是 不 可 能 的 。 

但 是 随 着 项 目 涉及 的 人 数 和 任务 数量 的 增加 ， 这 样 的 管理 手法 就 会 
出 现 问 题 。 用 纸 来 管理 既 影 响 开 发 速度 义 不 适 合 在 多 人 之 间 共 享 信息 。 

可 能 有 人 认为 用 Excel 进行 管理 应 该 还 是 可 行 的 ~， 但 因为 Excel 自 
号 并 不 是 专门 的 问题 管理 工具 ， 所 以 在 稳定 性 等 方面 存在 问题 。 用 
Excel 制作 问题 管理 表 ， 并 将 其 存放 在 共享 日 录 中 进行 管理 ， 多 人 同时 
编辑 后 文件 就 损坏 了 ， 这 样 的 经 历 相信 大 家 都 有 过 吧 “。 

还 有 一 些 开发 现场 使 用 的 是 Microsoft Project” 。 该 产品 适用 于 项 目 经 
理 从 高 层次 的 视角 向 利益 相关 者 汇报 项 目的 情况 ， 并 不 太 适 合 现场 的 作 
业 管 理 。 和 Excel 相同 ， 在 多 人 同时 编辑 时 稳定 性 方面 存在 问题 。 除 此 
之 外 ， 纸 、 邮 件 、Excel 等 还 有 其 他 欠缺 的 地 方 ， 那 就 是 信息 的 统一 管 
理 和 检索 。 

对 于 后 来 加 入 项 目 或 团队 的 成 员 来 说 ， 过 去 的 事情 以 及 需求 等 信息 
统一 记录 在 一 处 ， 并 且 能 够 进行 检索 是 非常 重要 的 。 如 采 能 够 做 到 这 一 
点 的 话 ， 之 后 加 入 的 成 员 就 能 够 进行 目 学 ， 加 快 追赶 的 速度 。 最 终 项 目 





















































〇 实际 上 设法 用 Excel 进行 管理 的 开发 现场 不 在 少数 。 
@) 无 法 用 邮件 进行 管理 的 原因 在 第 2 章 说 明 过 了 ， 这 里 就 不 再 提 了 。 
(3) 微软 开发 的 项 目 管理 软件 程序 。 
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的 成 功率 也 会 相应 地 上 升 。 

多 数 的 缺陷 管理 系统 都 附带 有 Wiki 的 机 制 ， 该 机 制 能 够 在 信息 共 
享 方面 起 到 作用 。 例 如 使 用 问题 票 对 课题 进行 调查 和 交流 ， 最 后 把 调查 
获得 的 知识 以 及 确定 下 来 的 需求 等 总 结 记 录 在 Wiki 中 。 这 样 做 能 够 提 
高 信息 的 精确 度 ， 提 高 项 目 和 团队 的 工作 效率 。 




















4.1.3 ”导入 缺陷 管理 系统 的 优点 


可 能 和 之 前 的 说 明 有 所 重复 ， 这 里 证 我 们 从 软件 开发 项 目 这 一 大 至 
景 出 发 ， 再 来 确认 下 导 和 人 缺陷 管理 系统 的 优点 。 


seeeeeeseeeeseeeseeeseseeeeseseseeseeeeeeeeeseeeeseeeseeeeseeeeseeeseseeeeeeeeeeeeee 


@…… 具有 任务 管理 所 需 的 基本 功能 
缺陷 管理 系统 的 显著 优点 是 具备 下 列 这 些 功能 。 





e “必须 要 做 什么 ”这 样 的 任务 定义 

e“ 谁 来 做 ”这 样 的 职责 分 配 

e“ 什 么 时 候 完成 ”这 样 的 期 限 管理 

e“ 现 在 正 处 于 作业 中 还 是 已 经 完成 了 ”这 样 的 状态 管理 








另外 ， 作 为 项 目 中 专门 的 任务 管理 程序 ， 多 数 缺 陷 管 理 系统 都 是 以 
多 人 使 用 为 前 提 进 行 设 计 的 ， 因 此 高 稳定 性 及 高 可 对 性 也 是 其 主要 的 优 
点 之 一 。 








e@…… 直观 性 、 检 索性 较 强 

在 管理 复杂 项 目的 过 程 中 ， 将 项 目 中 的 问题 、 任 务 列表 以 各 种 形式 
显示 出 来 是 非常 重要 的 。 另 外 ， 能 够 检索 找到 过 去 的 各 类 处 理 记 录 也 是 
非常 重要 的 。 














e@…… 能 够 对 信息 进行 统一 管理 及 共享 


过 去 的 处 理 记 录 、 从 中 获得 的 知识 ， 以 及 项 目的 需求 等 对 于 项 目 来 
说 都 是 非常 重要 的 信息 ， 将 这 些 信息 统一 管理 并 共享 是 非常 重要 的 。 这 
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些 功能 加 上 之 前 提 到 的 高 检索 性 ， 使 得 缺陷 管理 系统 超越 了 单纯 的 任务 
管理 系统 的 范畴 ， 还 具备 了 知识 数据 库 的 特性 。 


e@…… 能 够 生成 各 类 报表 


统一 管理 数据 所 市 来 的 显 千 优点 之 一 就 是 易于 生成 各 类 报表 。 例 如 
每 周 生 成 的 在 进度 会 议 上 要 使 用 的 工作 完成 情况 报告 、 能 够 一 日 了 然 地 
笃 握 团队 状态 的 燃 尽 网 ， 以 及 回顾 客 说 明 时 使 用 的 甘 特 图 等 ， 缺 陷 管 理 
系统 能 够 方便 地 生成 各 式 各 样 的 报表 。 

能 够 以 怎样 的 程度 生成 怎样 的 报表 ， 这 方面 不 同 的 缺陷 管理 系统 会 
有 所 差异 。 有 些 是 作为 系统 的 基本 功能 提供 的 ， 有 些 是 以 插件 的 形式 提 
供 的 。 大 多 数 的 系统 都 提供 了 数据 下 载 功能 ， 如 采 没 有 符合 需求 的 报 
表 ， 可 以 下 载 数 据 后 使 用 电子 表格 等 软件 目 己 生成 报表 。 如 末 系 统 提供 
了 了 API 或 插件 系统 ， 还 能 够 用 其 来 目 由 地 开发 报表 功能 ， 这 部 分 内 容 稍 
后 会 详细 介绍 。 

随 关 团队 开发 的 推进 ， 需 要 报表 的 情况 会 越 来 越 多 。 强 大 的 报表 功 
能 就 意味 看 制作 报表 所 用 的 时 间 能 大 大 减少 ， 这 也 是 导入 缺陷 省 理 系 统 
的 显 痢 优点 之 一 。 





























e…… 能 够 和 其 他 系统 进行 关联 ， 具 有 可 扩展 性 


特别 想 强 调 的 就 是 这 一 点 。 随 看 缺陷 管理 系统 和 版 本 管理 系统 以 及 
持续 集成 ( Continuous Integration，CI ) 系统 之 间 的 关联 的 逐渐 深入 ， 从 
问题 的 发 生 到 代码 的 修改 内 容 、 测 斌 结果、 发 布 情况 等 所 有 的 内 容 都 可 
以 相关 联 地 进行 管理 。 

通过 使 用 该 功能 ， 就 可 以 从 版 本 管理 系统 的 提交 记录 追溯 到 原本 的 
问题 票 ， 确 认 原 本 的 修改 理由 ， 或 者 倒 过 来 检索 过 去 的 问题 找到 对 应 的 
问题 票 ， 青 从 问题 票 找 出 相关 联 的 提交 和 测试 结果 ， 以 了 解 该 问题 是 如 
何 解决 的 。 这 样 就 能 够 追溯 到 项 目 内 的 活动 的 各 个 方面 ， 使 得 可 追 漳 性 
有 飞跃 性 的 提高 。 具 体 方法 将 稍 后 叙述 。 

具备 和 外 部 系统 关联 的 可 扩展 性 也 是 导入 缺陷 管理 系统 的 显著 优 
点 。 大 部 分 的 缺陷 管理 系统 都 具备 插件 功能 或 者 能 够 从 外 部 操控 问题 票 
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的 API 接口 ， 因 此 能 够 满足 项 目的 各 种 需求 。 


4.1.4 ”什么 是 缺陷 驱动 开发 


使 用 缺陷 管理 系统 ， 以 问题 票 〈ticket ) 为 中 心 构 建 开 发 流程 的 方法 
论 称 为 缺陷 驱动 开发 (TiDD )。 这 个 名 字 是 仿照 测试 驱动 开发 TDD 
( Test Driven Development ) 这 一 敏捷 开发 的 方法 而 取 的 。 

实践 缺陷 驱动 开发 的 规则 原则 上 只 有 一 条 ， 那 就 是 “禁止 没有 问题 
票 的 提交 ”。 提 交 记 录 和 问题 票 必须 一 对 一 地 进行 管理 ， 以 此 来 明确 代 
码 修改 的 理由 ， 这 便 是 缺陷 驱动 开发 的 目的 所 在 。 


e@…… 缺陷 驱动 开发 的 具体 步 又 


缺陷 驱动 开发 每 次 都 是 以 在 新 功能 开发 和 bug 修正 时 新 建 记 有 内 容 
和 目的 的 问题 票 开 始 的 。 

其 次 是 根据 问题 票 的 内 容 对 代码 进行 修正 并 提交 。 这 时 在 提交 记录 
中 记 下 问题 票 号 是 非常 重要 的 ， 同 时 还 要 在 问题 肾 中 记录 下 提交 记录 
号 。 这 样 问题 票 和 代码 修正 提交 之 间 的 相互 关系 聘 建 立 起 来 了 ， 明 确 了 
代码 的 修改 理由 ,日 后 进行 问题 调查 也 变 得 容易 了 。 

缺陷 驱动 开发 是 方法 论 ， 对 工具 的 使 用 并 不 是 必需 的 。 如 果 只 是 关 
联 提交 记录 和 问题 取 的 话 ， 手 动作 业 也 是 可 行 的 。 实 际 上 手工 关联 提交 
记录 和 问题 票 的 开发 现场 并 不 在 少数 。 

时 说 如 此 ,但 如 末 能 够 合理 使 用 缺陷 管理 系统 的 话 ， 关 联 作 业 也 可 
以 实现 日 动 化 。 这 样 就 能 避免 操作 遗漏 ， 准 确 地 关联 提交 记录 和 问题 
昧 ， 进 而 促进 项 目的 可 视 化 。 

从 下 市 开始 将 主要 介绍 缺陷 管理 系统 ， 说 明 其 同 版 本 管理 系统 关联 
的 方法 。 态 外 ， 应 该 和 缺陷 管理 系统 关联 的 并 不 仅 限 于 版 本 管理 系统 。 
在 和 提交 相关 联 并 实行 CI 的 情况 下 ，CI 的 结 末 也 要 记录 到 问题 聚 中 ， 
以 方便 日 后 调查 。 因 此 还 会 讲解 和 CI 系统 关联 的 相关 内 容 。 
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-一 专栏 彻 搬 贯彻 缺陷 驱动 开 友 的 情况 

上 文中 提 到 了 在 缺陷 驱动 开发 的 实践 中 工具 的 使 用 并 不 是 必需 
的 ， 手 工 关 联 问 题 票 和 提交 也 是 可 行 的 。 话 虽 如 此 ， 手 动作 业 的 话 
容易 发 生 问 题 票 和 提交 之 加 的 关联 遗漏 。 

要 想 彻底 贯彻 缺陷 驱动 开发 ， 可 以 使 用 版 本 管理 系统 提供 的 客 
户 端 挂钩 ( client side hook ) 和 服务 器 端 挂 钩 ( server side hook )。 
在 上 述 挂钩 中 能 够 检查 提交 信息 中 是 否 包含 问题 票 号 ， 如 果 不 包 含 
的 话 则 拒绝 接受 该 提交 ( 或 Push )。 

这 样 惑 可 以 系统 性 地 保证 问题 票 和 提交 之 间 的 关联 ， 原 因 不 明 的 
修改 将 无 法 提交 到 代码 库 ， 项 目 也 就 更 安全 了 。 并 且 之 后 回顾 修改 时 
也 一 定 能 找到 作为 修改 原因 的 问题 票 ， 这 点 在 管理 上 非常 有 优势 。 

但 是 在 管理 方面 的 优势 有 所 增加 的 同时 ， 反 过 来 开发 的 速度 就 
可 能 受到 影响 。 这 方面 需要 权衡 考虑 ， 要 根据 项 目的 目的 和 状况 进 
行 平衡 。 
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4.2 主要 的 缺陷 管理 系统 


缺陷 管理 系统 "包括 OSS ( Open Source Software ) 以 及 商用 软件 在 
内 ， 有 很 多 可 供 选 择 的 产品 。 这 里 将 介绍 一 些 具 有 代表 性 的 产品 “。 





4.2.1 OSS 产品 





seeeeeeeeeseeeeeeseseeseeeseseeeseeeeeeeseeeeseeeeeeseeseeeseeseeseeseeeseeseeseeseeseeeeeeseeeseeseseeseeseeeseeeseeeseeeseeeeseeseeeeseeeseeeseeeeeeee 


Trac 是 基于 Python 的 缺陷 管理 系统 ( 图 4.1 )。 它 导 和 简单， 印象 
中 过 去 几乎 所 有 的 开源 项 目 都 使 用 Trac， 之 后 被 后 来 的 Redmine 以 及 
SaaS ( Software as a Service ) 形式 的 GitHub 和 PivotalTracker 等 逐渐 取 
代 ， 最 近 已 经 很 少 看 到 了 。 但 如 果 要 说 上 手 简 单 的 话 ，Trac 至 今 依 然 是 


第 一 选择 。 





图 4.1 Trac 


童 看 任务 单 新 建 任务 单 





Wiki WikiStart 起 始 页 | 索引 | 历史 


Welcome to the Trac Open Source Project. 


Trac is an enhanced wiki and issue tracking system for software development projects. Trac uses a 
minimalistic approach to web-based software project management. Our mission is to help developers 
write great software while staying out of the way. Trac should impose as little as possible on a team's 
established development process and policies. 


Try out our demos! 
for Trac 0.12 (old), 
Trac 1.0 (current), 

It provides an interface to SSubversion and GS*Git (or other version control systems), an integrated or Trac 1.1.x (devel) 

Wiki and convenient reporting facilities. 








也 可 以 称 为 bug 管理 系统 或 问题 管理 系统 。 
产品 的 具体 功能 请 参考 相关 资料 。 特 别 是 商用 产品 ， 因 为 其 价格 、 服 务 形式 以 及 
提供 的 功能 等 可 能 发 生变 化 ， 所 以 请 一 定 要 参考 供应 商 提供 的 信息 。 
(3 http://trac.edgewall.org/ 


日 OO 
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Trac 能 够 和 bug 管理 及 代码 管理 相关 联 ， 具 备 基 于 Wiki 的 信息 共 
享 等 项 目 所 需要 的 功能 ， 还 可 以 通过 插件 进行 各 类 扩展 。 

Trac 已 经 有 了 日 语 版 的 安装 包 。 日 本 的 开源 社区 也 相当 活 暑 ， 还 出 
版 了 相关 的 书籍 ”特别 是 由 志愿 者 提供 的 Trac Lightning 在 日 语 版 Trac 
的 基础 上 还 加 入 了 Subversion 和 Jenkins， 将 它们 合并 成 一 个 安装 文件 ， 
初次 使 用 时 非常 方便 。Trac Lightning 是 Windows 平台 的 安装 包 ，Linux 
平台 的 话 可 以 使 用 由 相同 人 员 开 发 的 Kanon 。 

Trac 原本 是 作为 程序 员 的 bug 管理 系统 而 开发 的 ， 因 此 用 户 界 面 比 
较 简 陋 。 如 果 团 队 中 有 程序 员 以 外 的 成 员 ，Trac 那 过 于 简陋 的 接口 就 可 
能 成 为 导入 Trac 的 障碍 。 








@.……… Redmine 


Redmine "是 比 Trac 稍 晚 的 基于 Ruby on Rails 框架 的 缺陷 管理 系 
统 (图 4.2 )。 因 此 ， 使 用 Ruby on Rails 的 项 目 导 入 Redmine 的 门槛 会 
比较 低 。 

Redmine 同样 具备 了 bug 管理 、 代 码 管理 、Wiki 等 必要 的 功能 ， 文 
持 插件 系统 ， 扩 展 也 比较 容易 。UI ( User Interface ) 方面 要 比 Trac 更 为 
易 用 、 溪 亮 ， 非 程序 员 使 用 起 来 也 基本 上 没有 障碍 。 

Redmine 的 日 语 开源 社区 规模 大 、 非 常 活跃 ”, 而 且 还 出 版 了 很 多 相 
关 的 书籍 “。 现 在 已 经 取代 Trac， 成 为 项 目 现场 常用 的 缺陷 管理 系统 。 

















就 中 国 国 内 的 情况 来 看 ， 目 前 好 像 还 没有 什么 活路 的 社区 或 相关 书籍 。 只 有 Trac 
的 0.12 版 支持 中 文 显示 。 译 者 注 
http://sourceforge.jp/projects/traclight/ 





http://kanon.ultimania.org/ 
http://www.redmine.org/ 


http://redmine.jp/ 


OOOOOO Ob 


http://redmine.jp/ 
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图 4.2 Redmine 


概述 国生 





using Ruby on Rails framework. 


司 问题 跟踪 


e Defect: 1222 打开 / 6859 
e Feature: 2840 打开 / 5390 
。 Patch: 416 打开 / 1980 


查看 所 有 问题 





Redmine is a flexible project management web application written 健 成 员 


Administrator: Jean-Philippe Lang 

Contributor: Chaoqun Zou, Daniel Felix, Etienne Massip, Filou 
Centrinov, Go MAEDA, Jan from Planio www.plan.io, Jan 
Niggemann (redmine.org team member), Jean-Baptiste Barth, 
Jim Mulholland, Jonas De Meulenaere, Kar| Heinz Marbaise, Lucile 
Quirion, Martin Denizet (redmine.org team member), Maxim 
Krusina, Mischa The Evil, Toshi MARUYAMA 


命 最 近 的 新 闻 


Redmine 3.0.1 and 2.6.3 (2 条 评论 ) 
由 Jean-Philippe Lang 在 3 天 之 前 添加 


Redmine 3.0.0 and 2.6.2 released (8 条 评论 ) 
由 Jean-Philippe Lang 在 28 天 之 前 添加 


Redmine 2.6.1 released (5 条 评论 ) 
由 Jean-Philippe Lang 在 2 个 月 之 前 添加 


Redmine 2.6.0, 2.5.3 and 2.4.7 released (12 条 评论 ) 
由 Jean-Philippe Lang 在 5 个 月 之 前 添加 


Redmine 2.5.2 and 2.4.6 released (6 条 评论 ) 
由 Jean-Philippe Lang 在 9 个 月 之 前 添加 


查看 所 有 新 闻 








@.……… Bugzilla 


Bugzilla 是 基于 Perl 的 缺陷 管理 系统 ( 图 4.3 )。 原 本 是 Netscape 公 
司 内 部 的 系统 ， 后 来 被 作为 OSS 公开 。 现 在 由 Mozilla 基金 会 继续 开 
发 ， 可 以 说 是 OSS 界 最 具 “ 历 史 和 传统 ”人 性质 的 缺陷 管理 系统 。 


图 4.3 Bugzilla 








Bd: rallE 


About 
Who Uses Bugzilla? 
Roadmap 
Meet the Team 
Release Information 
News 
Planet Bugzilla 
Security Advisories 











search bugzilla.org: OO oo 


About News Docs Support Download Features Contribute! 


Bugzilla 
Bugzilla is server software designed to help you manage software development. 
More about Bugzilla » 
News 
e Release of Bugzilla 4.4 and 4.2.6 [ 2013 May 22 ] 


e Release of Bugzilla 4.4rc2, 4.2.5, 4.0.10 and 3.6.13 [ 2013 Feb 19 ] 
e Release of Bugzilla 4.4rcl, 4.2.4, 4.0.9 and 3.6.12 [ 2012 Nov 13 ] 


More news » 





(D http://www.bugzilla.org/ 
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至 今 Mozilla ( Firefox )、Linux 内 核 、Java 的 IDE (Integrated 
Development Environment， 集 成 开发 环境 ) Eclipse" 等 历史 较 长 的 OSS 
项 目 都 使 用 Bugzilla 作为 缺陷 管理 系统 。 

Bugzilla 有 者 数量 众多 的 插件 ， 是 一 球 经 得 起 实际 使 用 的 优秀 系统 。 
但 UI 较 老 ,习惯 了 现代 Web 程序 的 用 户 可 能 用 起 来 比较 吃力 。 虽 然 几 
乎 没有 新 项 目的 开发 现场 会 选用 Bugzilla， 但 至 今 仍 有 相当 多 的 现场 还 
在 使 用 Bugzilla, 今后 也 会 继续 使 用 下 去 。 











@.……… Mantis 


Mantis 是 基于 PHP 的 缺陷 管理 系统 (图 4.4 )。 由 日 本 人 开发 ， 过 
去 在 日 本 曾 被 广泛 使 用 ， 但 近年 来 几乎 看 不 到 了 。 新 项 目 一 般 不 会 使 用 
Mantis， 但 在 参加 历史 较 久 的 项 目 时 ， 还 是 有 机 会 看 到 Mantis 的 。 


图 4.4 Mantis 








mantl 


BUG TRACKER 





Home Bugtracker Blog Phone Download Docs Demo Hosting Support Sponsors Development Contact Us 


MantisBT is a free popular web-based bugtracking system (feature list). lt is written in 
the PHP scripting language and works with MySQL, MS SQL, and PostgreSQL databases 
and a webserver. MantisBT has been installed on Windows, Linux, Mac OS, OS/2, and 
others. Almost any web browser should be able to function as a client. lt is released 
under the terms of the GNU General Public License (GPL). 


Featuring MantisTouch for iPhone, Android and Windows Phone 


MantisTouch for MantisBT ss Dashboard [rmantisbl]issvos 


manti 


i 14496, security, feedback, dregad, 全 
BUG TRACKER 


mantisbt © Add support tor the built-in soap ext... 
14871, api soap, assigned, rombert,@h 
EE 
view status 
TD GB 


Provide a simple API for outputting ... 


anNts 
hep -iWwww mantisbt.org OUGs Feedback 14869, other, resolved, rombert, 17 [> 并 
> Send Feedback MantiaTouch fo IPhone. Android and indows Phone Existing ‘duplicate of bug number n... 
CopyrigM © Victor Boctor - 2012 E5649. relationehiDs feedbac 7h 


CopyrioM © Victor Boctor - 2012 


After updating a project documentat... 
12955, attachments, assigned, davi 和 w 








14851. administration_ feedback 17 Hh 





(DD http:/www.eclipse.org/ 





@ http:/www.mantisbt.org/ 
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JIRA2 是 由 Atlassian2 有 偿 提 供 的 基于 Java 的 缺陷 管理 系统 (图 
4.5 )。 虽 说 是 商用 的 ， 但 有 30 天 的 免费 试用 期 。 该 产品 可 以 以 安装 文件 
或 SaaS 的 形式 提供 ， 功 能 丰 宣 。 如 果 项 目 预 算 人 允许 的 话 ， 可 以 考虑 使 
用 JIRA。 











S90 
YY 
X JIRA Overview Pricing What's New 
Plan, track, Work — 
ee “High priority work— Este sere -| Detls 娘 
smarter and faster Ce 
Find faers IRKD ” Siory™ Status: Ai ” Assignee: Al 
JIRA is the project tracker for teams planning, My Open lssues nds 
0 g eporied by Me Onder by Key * IRKD / IRKD-1 
Dac ae eg rest POO. ecenty Vewed ls es 站 As a user, | would like to 
A Issues eles es 
Thousands of teams choose JIRA to capture 国 IRKD-2 pe 
As a user, | would lke to attac msent | | Ag Boasd | | Open | h Megss 
and organize issues, assign work, and follow SR 下 
team activity. At their desks, or on the go with ee As a User, | woukd Hike to Yew mm Type oD) 
2 oh ed IRKO4 Saatu # Ciosed (View Vicrifiow) 
the new mobile interface, JIRA helps teams get IRKD Planning As a user, | would ke to resolve Pror 个 Major 
the job done. Reoent Dugs 圆 IRKD-5 Resol Unresoved 
As a User, | would lke to so Arect None 
Fix Ver 20 
Label Nom 
oa Sprin a 
Try it for Free Rans 
et Seory Pomt § 
Activity 
MM Comments WorkLog History 














从 bug 的 管理 到 需求 的 管理 ，JIRA 能 够 以 不 同 的 粒度 管理 问题 票 ， 
还 可 以 和 版 本 管理 系统 进行 关联 。JIRA 拥有 大 量 的 插件 ， 能 够 满足 各 
类 需求 。JIRA 同样 支持 日 语 ”。 但 是 Wiki 功能 由 同属 于 Atlassian 的 其 他 
产品 Confluence 来 提供 ， 这 点 需要 注意 。 


https://www.atlassian.com/software/jJira/ 

https:/www.atlassian.com/ 

JIRA 本 身 不 支持 中 文 ， 但 有 收费 的 第 三 方 汉 化 插件 http://www.confluence.cn/pages/ 
译 者 注 


https:/www.atlassian.com/software/confluence/ 





viewpage.action?pageld=2164040。 


© QOO 
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©…… YouTRACK 


YouTRACK 是 以 IntelliJ IDEA 等 IDE 出 名 的 JerBrains “所 提供 的 基 
于 Java 的 缺陷 管理 系统 (图 4.6 )。 这 也 是 一 款 收费 软件 ， 但 10 个 用 户 
之 内 的 可 以 免费 使 用 。 提 供 安 装 文件 和 Saag 两 种 形式 。 但 需要 注意 的 
是 该 软件 还 没有 中 文 版 本 。 


图 4.6 YouTRACK 





De 


8 


过 YouTRACK ee 


(© oT: To :A Te [S 





The Agile Issue Tracking and Project Tracking Tool 







二 YouTRACK 


IssueList ~ | Agile Board 





站 -一 一 | 
projects 一 里 S 外 2 二 本 | 二 0 
Kanban sampla 4 | 罕 区 SCS-80276 Quickly Add Contact Today 
Scrum Sample 45 
i7 C SCS-80230 Set Preferred Customer Discount Yesterday 
y Tags » f \ 
| = 加 家 © SCs-14131 册 Yesterday  [*] 





D Saved Searches (10) ~ 
&| Assigned to me 0 
2| Commented by me 0 | IT7 M SCS-14081 Create Preferred Customer September 9 
&| Customer Management | 0 
&| Kanban 2 Backlog 0 


LT ©€ SCS-14084 September 9 


1 M SCS-14079 Design Email Template September 1 














2 Kanban sample Backlog 20 癌 | 计 N SCS-110 Check duplicates August 29 

&| Kanban Sample Project 0 

Od 90 N SCS-102 Design Dashboard Page August 17 

A Sum Ploct sampe Bs 1 N SCS-97 Export Rules August 16 
Unassigned in KCS 35 


Pivotal Tracker 是 PivotalLab 提供 的 缺陷 管理 系统 ( 图 4.7 )。 特 别 适 
合 于 敏捷 开发 的 Scrum 开发 流程 。 只 提供 Saag 形式 的 产品 。 





(DD http:/www.jetbrains.com/youtrack/ 
© http:/www.jetbrains.com/ 
3) http:/www.pivotaltracker.com/ 
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图 4.7 Pivotal Tracker 


P 1 V @) TALTRA 人 KEIR PROJECTS v DASHBOARD REPORTS HELP 。 TAKAFUMIIKEDA Y 
My Sample Project "velocty8 
CURRENT BACKLOG ICEBOX EPICS MORE™ PROJECT STORIES ~ Q 
* 3 |22Jul-Current Pls:2017 Y le6 Product browsing pagination not | 
高 。 shopping Shoppershould be ableto clickona 》 再 引 中 search, shopping Shopper should be able Start | working in IE6 
product, and see all product details, including to search for product > 食 瑟 Integrate with automated order fullfill ss 
photos Initial demo to Investors nis ment system 
人 cart, shopplng Shopper should be able to add checkout shopping Shoppershouldbe | Start | P 仿 三 eplc native iPhone app to allow product -= 三 昌 
Product to shopping cart ableto enter creditcard informationand browsing and checkout 
>》 全 = 中 cart, shopping Shopper should | Accept | Rojoct | shipping address Facebook app, allowing userstoshare _. .ss 
be able to view contents of checkout, shopping Integrate with payment Star | favorite products 























a 
hopping ontt gateway 
F 注 二 cart, shopping Shopper should 语 引号 checkout, needs discusslon, shopplng When Start | 
be able to romovp produot kom shopper submits order, authorize total 
ih ns product amount from payment gateway 
> 食 。 cart, shopping Cart manipulation should | Detiver | A ng Ifsystem fails to [Er 
oh. authorize payment amount, display error 
盘 shopplng Some product photos not scaled 莉 症 | message to shopper 
properly when browsing Produc 和 俩 。 checkout, shopplng Ifauthorization is | 
上 个 _ 中 shopplng Shopper should be able to em: c successful, show order number and 
recommend a product to a friend confirmation message to shopper 
[RE search configure solr for full text searchin Start | i 
9 本 admin, checkout, shopplng Send notifica EE | 
tion email of order placement to admin 
> 请 = orders Shopper should be able to check = Start 
status of order by entering name and 
order number 
» ~ 0) orders Shopper should be able to ask Start 


作为 Web 应 用 程序 Pivotal Tracker 非常 有 趣 ， 并 日 能 够 通过 拖 电 直 
观 地 新 建 、 移 动 问题 票 。 多 人 同时 编辑 时 能 够 在 画面 上 实时 地 反映 出 
来 。UI 界面 也 易于 使 用 。 但 是 需要 注意 Pivotal Tracker 没有 中 文 版 本 。 

如 果 团 队 成 员 习 惯 于 Scrum 的 话 ，Pivotal Tracker 是 非常 方便 且 吻 
用 的 工具 。 











ds Backlog 


Backlog "是 由 日 本 的 nulab “提供 的 缺陷 管理 系统 (图 4.8 )。 支 持 
SaaS 和 安装 文件 两 种 形式 。 因 为 是 日 本 公司 的 产品 ， 所 以 对 日 语 的 支持 
方面 完全 没有 问题 ， 当 然 也 支持 多 语言 ， 包 括 中 文 “。 





(D http://www.backlog.jp/ 
@) http:/www.nulab.co.jp/ 
3) http://backlogtool.conycn/ 
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图 4.8 Backlog 


Ob Dashboard ”项 目 ”最近 浏 览 的 课题 ”最 近 浏览 的 Wiki 。 课题 第 先 





区 ysylife， 您 好 


|》 团队 开发 相关 技术 的 项 目 


个 人 设置 | 空间 设置 | 帮助 | 退出 


开始 设置 您 的 空间 吧 。 

二 氏 添加 用 户 颖 设置 空间 徽标 

这 计 和 一 个 站 尝 一 请 添加 成 员 至 您 的 空间 ， 请 自 定义 空间 徽标 ， 

请 在 您 多 空间 添加 二 个 项 具 一 ”现在 就 洲 请 他 们 吧 。 它 将 会 显示 在 此 空间 页 面 的 左上 角 。 





最 近 更 新 


| 
| (团队 开发 入门 翻译 (TRANS_TEAMWORK) 


























, 习 ysylife 先生 /女士 草 法 一 了 课题 多 约 1 分 钟 前 
人 -一 
GD 。 TRANS_TEAMWORK-2 第 4 章 : TravisCI 已 经 开始 支持 私有 的 代码 库 ， 添 加 相关 内 
我 的 课题 中 容 
> 至 此 我 们 一 起 确认 了 什么 是 版 本 管理 系统 ， 一 边 回顾 版 本 管理 系统 的 历史 ， 一 边 涉 
提交 者 (4) 及 了 如 今 的 开发 现场 所 面临 的 问题 。 还 看 了 分 布 式 版 本 管理 系统 的 使 用 方法 、 版 本 
管理 系统 应 该 管理 的 内 容 以 及 有 效 的 管理 方法 。 怎 么 样 
KEY 标题 优先 级 状态 期 限 日 全 > 这 样 就 能 够 记录 下 什么 时 候 、 谁 、 进 行 了 怎样 的 修改 ， 任 何 时 候 都 可 以 进行 追查 。 
| 并 且 还 能 够 做 到 根据 需要 回 滚 到 过 去 某 一 时 刻 、 多 版 本 并 行 开 发 、 有 效 地 进行 数据 
| TRANS_TEAMWORK 库 的 模式 变更 管理 。 
一 test 谍 题 未 处 理 a i | Se 
-1 中 > 但 是 只 有 版 本 管理 系统 的 话 还 是 不 知道 为 什么 要 进行 这 样 的 修改 ， 解 决 这 个 问题 就 
| 需要 用 到 缺陷 管理 系统 。 
| TRANS_TEAMWORK 第 4 章 : TravisCI 已 经 开始 支持 私 。 办。 RR 旦 导 发 表 评论 
-2 有 的 代码 库 ， 添 加 相关 内 容 
| 本 ysylife 先生 /女士 基 法 :一 了 课题 入 2 分 钟 前 
| me 
| TAMWORK 第 3 章 前 半 部 分 获 。 ”未 处 理 人 DTRANS_TEAMWORK-3 第 3 章 前 半 部 分 


> 什么 是 版 本 管理 系统 

> 合理 、 有 效 地 利用 版 本 管理 系统 是 顺利 地 进行 团队 开 必 不 可 少 的 、 最 基础 的 部 分 。 
第 3 章 后 半 部 分 只 下 型 是 否 正确 理解 了 版 本 管理 系统 的 概念 及 其 意义 将 直接 左右 团队 所 发 布 产品 的 品质 中 
最 基本 的 部 分 。 

> 究 况 什么 是 版 本 管理 系统 ? 版 本 管理 系统 是 将 什么 时 候 、 谁 、 对 文件 做 了 怎样 的 修 
he A a Ue he hh TA PJ At FE A i TE hh 2 be 4 701 hh 1 Ac hp bn EE /Dn 


Backlog 能 够 与 bug 管理 、 代 码 管 理 相 关联 ， 也 支持 Wiki 的 信息 共 
享 ， 必 要 的 功能 可 谓 一 应 俱全 。10 名 用 户 、1 个 项 目 以 内 可 以 免费 使 用 。 

Backlog 以 亲切 易 用 的 UI 以 及 可 爱 的 设计 为 特征 ， 还 可 以 使 用 表情 符 
号 ， 像 使 用 手机 一 样 发 送 表情 。 程 序 员 以 外 的 人 用 起 来 也 能 得 心 应 手 “。 


TRANS_TEAMWORK 
-4 























GitHub “已 经 在 第 3 章 介 绍 过 了 。 作 为 缺陷 管理 系统 ，GitHub 同样 
具备 不 俗 的 功能 (图 4.9 )。 检索 功 能 等 可 能 稍微 弱 了 些 ,， 但 和 代码 管理 
的 交互 做 得 非常 出 色 ， 还 具备 Wiki 的 功能 。 并 且 还 有 名 为 GitHub Pages 
的 用 于 建立 项 目 网 页 的 功能 ， 以 及 类 似 于 Travis CI 的 CI 工具 。 可 以 上 毫 
不 夸张 地 说 ，GitHub 能 够 提供 OSS 项 目 所 需要 的 所 有 功能 。 





(DD 本 书写 作 时 就 使 用 了 Backlog 的 免费 缺陷 管理 系统 ， 用 Backlog 提供 的 Git 来 管 
理 原稿 。 
@) https://github.com/ 
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图 4.9 GitHub 





GO 中 This repository ~ Search ortypeacommand © “ Explore Gist Blog Help 本 ikeike443 | be 


EE playframework / playframework SUnwatch ~ 390 炊 Unstar 3398 时 Fork 1,097 


Browse Issues Milestones | New Issue | 
| 255 Dpen | 1,142 Closed Sort: Newest 贺 ES 9 > 
VU ] 9 < 4 
Everyone's lssues 255 加 | [8) | 


Created by you 0 i Upgrade to sbt idea 1.5.1 final #1397 和 
Opened by huntc an hour ago 器 1commen t 到 
Mentioning you 0 
© Replace the text "Play 2" or "Play 2.1" with just "Play" #1396 a 
Opened by huntc an hour ago 
No milestone selected 册 ~ Eh 
i read scala version from runtime #1395 


Opened by XuefengWu 4 hours ago 器 2comments 
Labels 














© [LESS/2.1.2] LESS compilation taking too long #1394 
duplicate 1 Opened by srikanth7 6 hours ago 
eS 5 | @ keep-Alive/POST fix in Play 2.0.3 ps 
| | ds-verificati 4 Opened by brikis98 15 hours ago 
ooot 9 i update javaGuide3.md - correct onApplicationStart method name to onStart #1392 
和 improvement 0 Opened by richardbroersma 16 hours ago 晒 1 commen t 
pondein 9 i Removing closed channels from group #1391 
ta bug 0 Opened by nraychaudhuri a day ago [a 2 comments 
ei 0 | © Shared dependency-free reverse router across multiple projects #1390 











问题 在 于 没有 中 文 版 本 ， 并 且 基 本 上 只 有 面向 程序 员 的 功能 ， 程 序 
员 以 外 的 项 目 成 员 使 用 起 来 可 能 有 些 困难 。 

GitHub 虽然 可 以 免费 使 用 。 但 如 采 不 想 让 其 他 人 看 到 项 目的 内 容 的 
话 ， 就 需要 购买 私有 代码 仓库 ， 将 项 目 设 置 为 私有 ， 这 点 请 注意 。 第 3 
草 中 已 经 提 到 过 ，GitHub 还 提供 安装 文件 形式 的 GitHub Enterprise， 在 
公司 内 部 使 用 的 话 可 以 考虑 GitHub Enterprise。 

















4.2.3 选择 工具 ( 缺陷 管理 系统 ) 的 要 点 





至 此 我 们 对 主要 的 缺陷 管理 系统 进行 了 介绍 。 无 论 是 OSS 还 是 商用 
产品 ， 数 量 都 相当 多 ， 选 择 起 来 比较 困难 。 并 且 缺 陷 管 理 系统 并 不 像 版 
本 管理 系统 以 及 CI 工具 那样 有 和 负 规 的 选项 。 

除了 上 面 介绍 的 几 球 之 外 ， 还 有 很 多 其 他 的 工具 ， 大 家 也 可 以 试看 
挑选 适合 目 己 的 开发 现场 的 工具 。 选 择 工 具 时 需要 确认 的 关键 点 因 开发 
现场 而 异 ， 但 特别 需要 注意 的 是 工具 所 提供 的 扩展 性 如 何 ， 以 及 是 否 易 
于 实现 。 

缺陷 管理 系统 和 版 本 管理 系统 以 及 CI 工具 不 同 ， 工程 师 以 外 的 项 
目 利 益 相关 者 也 会 比较 多 地 接触 到 缺陷 管理 系统 。 并 且 很 多 缺陷 管理 系 
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统 都 和 团队 的 业务 流程 密切 相关 。 因 此 ， 能 和 否 扩展 缺陷 管理 系统 ， 使 其 
灵活 地 适应 现场 的 开发 流程 ， 这 一 点 同样 很 重要 。 

这 里 介绍 的 缺陷 管理 系统 都 支持 以 某 种 形式 进行 扩展 ， 一 般 会 提供 
REST API 或 插件 机 制 等 。 

如 采 选 用 本 次 介绍 的 工具 之 外 的 其 他 工具 ， 选 择 时 一 定 要 注意 其 扩 
展 性 。 





-一 专栏 缺陷 管理 系统 的 应 用 事例 
原本 用 于 软件 开发 项 目 中 的 任务 管理 的 缺陷 党 理 系统 ， 近 年 来 
逐渐 被 扩展 应 用 到 了 其 他 各 个 领域 。 
例如 ， 笔 者 所 在 的 团队 就 在 下 列 业务 中 用 到 了 缺陷 管理 系统 。 


@ 用 户 咨询 的 管理 
@ 委托 其 他 部 门 的 工作 的 管理 


这 是 因为 缺陷 管理 系统 所 具有 的 定义 任务 、 确 定 责任 人 和 期 限 
这 样 的 任务 进度 管理 功能 对 几乎 所 有 的 工作 都 是 通用 的 。 

想必 本 书 的 读者 基本 上 都 是 软件 开发 相关 的 工程 师 ， 缺 陷 管 理 
系统 能 够 在 各 类 业务 中 起 到 作用 ， 所 以 请 一 定 在 软件 开发 项 目 之 外 
也 试 着 应 用 一 下 。 
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随 大 缺陷 管理 系统 的 导入 ,任务 的 管理 变 得 人 简单， 项 目 也 开始 顺利 
运转 ， 接 着 应 该 者 手 的 就 是 和 版 本 管理 系统 的 关联 了 。 关 联 问 题 票 和 代 
人 码 的 修改 能 够 使 问题 或 bug 的 调查 变 得 方便 ， 由 此 对 项 目的 管理 也 会 更 
为 得 心 应 手 。 











4.3.1 通过 关联 实现 的 功能 


eeeeeeeeeseeesseeeeseeseeseseseeesseeseeeseeseeeeeseseeseeseeseeseeseeseeeeseeeeeseeseeeseee 


e…… 从 提交 链接 到 问题 村 


利用 这 个 功能 能 够 从 代码 的 修改 妃 漳 到 原本 的 问题 票 。 特 别 是 在 以 
开发 者 的 角度 来 调查 代码 的 修改 时 ， 该 功能 非常 方便 。 在 缺陷 管理 系统 
和 版 本 管理 系统 密切 整合 的 系统 中 可 以 使 用 该 功能 ， 具 体 来 说 有 Trac、 
Redmine 、Backlog、Github 等 系统 。 

相反 ， 缺 陷 管 理 系统 使 用 JIRA 或 Pivotal Tracker， 版 本 管理 系统 使 
用 为 外 的 Git (GitHub ) 的 情况 下 ， 要 在 版 本 省 理 系统 的 提交 记录 中 添 
加 缺陷 管理 系统 的 问题 票 的 链接 就 比较 困难 了 ， 这 点 请 注意 。 

















e…… 从 问题 票 链接 到 提交 


和 上 述 功能 相反 ， 这 是 一 个 从 问题 票 出 发 ， 追 查 做 出 了 怎样 的 修改 
的 功能 。 主 要 是 在 从 QA 负责 人 人、 顾客 或 者 和 顾客 立场 相近 的 利益 相关 
者 的 角度 出 发 ,来 确认 发 生 问题 的 始 未 、 调 查 影 响 范围 时 ， 该 功能 非常 
方便 。 即 使 在 缺陷 管理 和 版 本 管理 使 用 各 自 独 立 的 系统 的 情况 下 ， 只 要 
进行 适当 的 配置 ， 多 数 情 况 下 还 是 能 够 使 用 该 功能 的 ， 所 以 应 该 尽量 地 
加 以 利用 。 
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e@…… 提交 的 同时 修改 问题 票 的 状态 


这 是 一 个 在 回 版 本 管理 系统 进行 提交 的 同时 修改 相关 联 的 问题 标的 
状态 的 功能 。 该 功能 能 够 使 开发 人 员 的 提交 作业 和 项 目的 工作 流程 相关 
联 ， 带 助 加 快 开发 速度 。 


4.3.2 ”天 联 的 配置 万 法 


几乎 所 有 的 缺陷 管理 系统 都 具备 和 版 本 管理 系统 相关 联 的 功能 ， 配 
置 的 方法 也 基本 相同 。 实 际 进行 配置 时 ， 只 要 参考 文档 或 相关 书籍 等 资 
料 ， 应 该 都 能 够 顺利 地 进行 。 

这 里 , 我 们 以 使 用 Git 版 本 管理 系统 为 前 提 ”, 就 上 述 介绍 的 缺陷 管 


理 系统 之 中 的 一 些 主要 产品 的 配置 方法 进行 简单 的 说 明 。 


eeeeeeeeeseeeseeseeeseeseseeeseseeeeeseeeseeeeeseeeseeseeeeeseeeeeseeseeeseeeeseeeseeeeeseeeeseeeseeeeeseeeseeeeeeeeee 








4.3.3 _GitHub 


seeeeeeeeseeseeeeeeeseeeeeeseeseeseseeeseeeseeseeeeeseeeeseeeeeeseseeseseeeseeseeeseeeeeeseeeseeeseeeeseeseeeseeseeeseeseeseeeeeeeseeeeseeeeseeeseeeseeeee 





Oe GitHub 的 issue 








关联 GitHub 上 自 带 的 issue 功能 和 代码 修改 是 非常 简单 的 ， 只 需 在 提 
交 记 录 中 像 下 面 这 样 加 入 issue 的 号 码 即 可 。 

Basselcl el 

这 样 从 提交 到 21 号 issue 的 链接 就 建立 起 来 了 。GitHub 还 会 在 21 
号 的 issue 中 添加 相应 的 提交 记录 的 链接 ， 并 把 其 状态 修改 为 close。 可 
以 说 必要 的 功能 是 一 应 俱全 的 。 

像 这 样 ，GitHub 较 好 地 具备 了 关联 缺陷 管理 系统 和 版 本 管理 系统 的 
功能 。 就 这 样 运用 GitHub 应 该 也 没有 什么 太 大 的 问题 ， 只 是 很 多 开发 
团队 已 经 在 使 用 其 他 缺陷 管理 系统 。 另 外 ， 因 为 需要 使 用 GitHub 所 不 
具备 的 报表 生成 功能 而 另行 选用 其 他 缺陷 管理 系统 的 团队 也 不 在 少数 。 

在 这 样 的 情况 下 ， 可 以 将 GitHub 彻底 地 作为 版 本 管理 系统 来 使 用 ， 




















(D 关于 Subversion 和 缺陷 管理 系统 的 关联 方法 ， 请 参考 文档 、 书 籍 或 网 络 资料 等 。 
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使 用 其 他 的 产品 作为 缺陷 管理 系统 。GitHub 同样 提供 这 样 的 功能 。 


@…… Service Hooks 


GitHub 为 每 个 代码 库 提 供 了 和 其 他 服务 相关 联 的 机 制 (图 4.10 )， 
该 机 制 称 为 Service Hooks。 它 能 够 在 癌 Git Push 代码 时 通过 Hook( 挂 
钓 ) 和 其 他 服务 进行 信息 交互 。 在 各 代码 库 的 菜单 中 依次 选择 Settings> 
Webhooks&Services>Configure services， 了 网 可 以 进行 确认 。 配 置 时 需要 
该 代码 库 的 Admin 权限， 这 点 请 注意 。 


图 4.10 Service Hooks 





Options 


Collaborators 


Webhooks & Services 


Deploy Keys 





Webhooks Add webhook 


Webhooks allow external services to be notified when certain events happen on GitHub. When the specified 
events happen, well send a POST request to each of the URLs you provide. Learn more in our Webhooks Guide. 


We also Support integrations with third-party services. Looking for those? 


Services 
< Select a service to set up your integration 


ActiveCollab 


Backlog 





如 图 4.10，GitHub 提供 了 世界 上 几乎 所 有 系统 的 Hook。 从 中 找 出 
自己 所 使 用 的 缺陷 管理 系统 的 Hook 并 进行 配置 ， 这 样 就 实现 了 GitHub 
和 缺陷 管理 系统 的 关联 。 

而 万 一 没有 提供 相应 的 Hook 的 话 ， 则 有 以 下 两 个 办 法 。 

其 一 就 是 配置 Webhooks (图 4.11 )。 这 是 一 种 向 设 定 的 URL 发 送 
固定 格式 的 POST 请 求 的 通用 做 法 。 在 和 公司 内 部 独自 开发 的 系统 关联 
时 就 能 发 挥 作用 。 顺 便 说 一 下 ，GitHub 发 送 请 求 的 服务 器 的 IP 地 址 是 
公开 的 “， 所 以 在 和 公司 内 部 系统 进行 关联 时 还 可 以 使 用 IP 过 滤 ， 消 除 


(D http://developer.github.cony/v3/meta/ 
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安全 方面 的 隐患 。 
图 4.11 Webhooks 


Webhooks /Add new 


We'll send a POST request to the URL below with details of any Subscribed events. You can also specify which 
data format you'd like to receive (JSON, x-www-form-urlencoded, etc). More information can be found in our 
developer documentation. 





Payload URL * Payload version 
https://example.com/postreceive application/vnd.github.v3+form Y 


Which events would you like to trigger this webhook? 
@® Just the push event. 
已 Send me everything. 


Let me select individual events. 


加 Active 
We will deliver event details when this hook is triggered. 











其 二 就 是 自行 开发 Service Hooks。GitHub 的 Service Hooks 是 作为 
OSS 公开 在 GitHub 上 的 ~”。 只 要 按照 说 明 开发 Hook 并 公开 ,全 世界 的 工 
程 师 就 都 能 使 用 该 Service Hook。 


e@…… GitHub 和 Pivotal Tracker 的 关联 


Pivotal Tracker 是 GitHub 的 Service Hooks 中 提供 Hook 的 服务 
Re 

只 需要 配置 Pivotal Tracker 所 发 行 的 Token 和 对 象 Branch (分 支 ) 
即 可 运行 (图 4.12 )。Branch 处 空白 的 话 ， 每 次 Push 修改 时 都 会 监听 所 
有 分 文 ， 并 在 相应 的 PivotalTracker 的 问题 聚 中 添加 链接 。EndPoint 通 
第 可 以 为 空 ，Pivotal Tracker 的 话 只 有 在 使 用 custom domain 的 情况 下 才 
需要 配置 EndPoint。 


https:Wgithub.comygithub/github-services 
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图 4.12 GitHub 的 Service Hook ( Pivotal Trakcer ) 





Branch 


Endpoint 


[) Active 


Update settings 


Install Notes 


1. "tokem' is your Pivotal Tracker API Token. This is at the bottom of your "My 
Profile' page. 

2. "branch" is the name of the branch you want to listen for commits on. ff 
none is provided it will listen on all branches. 


3. "endpoint' is an optional endpoint for a custom Pivotal Tracker installation. 
Leave this blank to use "https J//www.pivotaltracker.com". 











配置 完成 后 ， 在 提交 时 添加 如 下 提交 记录 ， 则 对 应 的 问题 昧 (这 里 
是 问题 票 ID123456 ) 和 修改 的 内 容 就 关联 起 来 了 。 
[#123456] 修正 了 发 送 邮 件 的 pug 
用 “[] ”将 票 号 (# 号 码 ) 围 起 来 。 这 时 如 采 该 问题 标的 状态 是 
“not started” 的 话 ， 则 状态 会 日 动 更 新 为 “started”。 
耕 要 在 关联 修改 的 同时 把 问题 票 的 状态 设置 为 “finished”， 可 以 像 
下 面 这 样 添加 提交 记录 。 
[Fixes #123456] 修正 了 发 送 邮 件 的 时 机 问题 
其 他 的 格式 可 以 参考 Pivotal Tracker 的 帮助 ”"。 成 功 关联 Pivotal 
Tracker 和 GitHub 的 话 ， 如 图 4.13 所 示 ， 问 题 票 和 代码 修改 之 间 的 关联 
就 建立 起 来 了 。 














JJ https:/www.pivotaltracker.com/help/api?version=v3#scm post commit message syntax 
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图 4.13 ”建立 问题 票 和 代码 修改 之 间 的 关联 





































































































| | 
| 批量 下 载 时 的 文件 名 中 混 有 多 余 的 文字 [| 
2 
FI [sj ee 
STORY TYPE 请 Feature v 
POINTS _ 1Point v | 
STATE | Accept | Delivered ™ 
REQUESTER 康 树 奥 村 严 
OWNER 康 树 奥 村 ™ 
BUGZILLIA ID 24127 图 
Requested 15 May 2013, 8:09am 
DESCRIPTION 
通过 批量 下 载 下 载 的 文件 名 中 混 有 多 余 的 文字 
-| 

















LABELS 
| "| 
TASKS 
| Add a task 2 区 
ACTIVITY All Activity ™ 
Commit by buster84 24 May 2013, 6:27pm 
让 [Fixed #49891579 #49891623 #49891631] Create report 
file after syncing data. 


https://github.com/Shanon/DeeElle/commit 
/201aa967f01653c6f2a8e3c836e3f455541524ba 








人 GitHub 和 JIRA 的 关联 


JIRA 也 和 Pivotal Tracker 一 样 ，GitHub 在 Service Hooks 中 提供 了 
相应 的 Hook。 只 需 输 入 必要 的 信息 ， 就 能 和 GitHub 进行 关联 。 

提交 时 输入 如 下 提交 记录 即 可 。JIRA 的 情况 下 ，C00LAPP-123456 
这 部 分 是 对 应 的 问题 票 号 。 

[#C00LAPP-123456] 修正 了 发 送 邮件 的 bug 

使 用 Service Hooks 的 关联 是 以 代码 库 为 单位 进行 配置 的 ， 所 以 每 
增加 1 个 代码 库 都 必须 对 其 进行 配置 。 如 果 觉 得 麻烦 的 话 可 以 用 一 些 灵 
活 的 方法 来 应 对 ， 例 如 用 JIRA DVCS Connector Plugin 7 对 GitHub 





(DD) https://marketplace.atlassian.com/plugins/com.atlassian.jira.plugins.jira-bitbucket- 


connector-plugin 
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Organization 进行 统一 配置 等 。 各 位 可 以 试 着 使 用 这 些 功能 。 





4.3.4 Trac/Redmine 


在 Subversion 还 是 主流 的 版 本 管理 系统 的 时 代 ， 比 较 多 见 的 是 使 用 
Trac 或 者 Redmine 对 问题 票 和 代码 进行 管理 。 那 时 一 般 是 自行 在 服务 需 
上 建立 Subversion 的 代码 库 ， 将 Trac 或 Redmine 设置 为 代码 库 的 浏览 
大 ， 有 再 配置 相互 之 间 的 关联 。 

但 自从 GitHub 出 现 后 ，Git 的 简洁 以 及 GitHub 的 Pull Request 的 便 
利 开 始 逐 渐 为 人 所 知 并 得 到 普及 ， 现 在 已 经 没有 太 大 的 必要 特意 肯 行 构 
建 Git 仓库 ， 并 使 用 Trac 或 Redmine 作为 代码 库 的 浏览 器 了 。 坦 率 地 说 ， 
如 今 使 用 GitHub 的 费用 也 已 经 比较 合理 了 。 完 全 可 以 用 GitHub 作为 代码 
库 浏览 妖 ， 而 将 Trac 或 Redmine 作为 纯粹 的 缺陷 管理 系统 来 使 用 。 

GitHub 的 Service Hooks 中 已 经 提供 了 Trac 和 Redmine 的 服务 ， 请 
加 以 有 效 使 用 。 














4.3.5 Backlog 


Backlog 原本 是 作为 提供 类 似 于 Trac 和 Redmine 的 功能 的 SaaS 开 
始 开 发 的 。 其 特征 是 支持 Subversion， 和 Trac 和 Redmine 一 样 可 以 作为 
代码 库 浏 览 喜来 使 用 ， 问 题 票 和 代码 修改 的 关联 容易 。 

Backlog 最 近 也 开始 支持 Git 了 。 在 线 托管 Git 的 SaaS 除了 GitHub 
之 外 并 不 多 ， 日 本 国内 比较 有 名 的 也 就 只 有 Backlog 了 。 使 用 Git 作为 
版 本 管理 系统 的 话 ，GitHub 在 大 多 数 情 况 下 都 是 最 好 的 选择 。 但 考虑 到 
项 目的 差异 以 及 预算 ，Backlog 也 是 非常 有 竞争 力 的 选项 。 

并 且 ，GitHub 的 Service Hooks 中 公开 有 Backlog 服务 ， 所 以 可 以 
采用 这 样 的 方法 : 将 Backlog 作为 纯粹 的 缺陷 管理 系统 来 使 用 ， 版 本 管 
理 系 统 则 使 用 GitHub。 
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© Backlog 和 Git 的 关联 


关联 Backlog 和 Git 的 配置 比较 简单 。 可 以 分 别 为 每 一 个 项 目 进行 
RAR 
连接 课题 和 关键 字 ” 即 可 。 


图 4.14 ”关联 Backlog 和 Git 的 配置 

















项 目 设置 
编辑 项 目 ( 关 假如 您 不 是 此 项 目 成 员 ， 某 些 功能 链接 将 失效 。 ) 
记 项 目 设置 
i ? 
编辑 项 目的 基本 设置 Git 设 置 as 
主题 
种 类 回 连接 课题 和 关键 字 
类 别 提交 信息 将 作为 相关 课题 的 新 评论 ， 若 含有 某 些 关键 字 (如 : #cioses 4fixes 等 ) ， 课 题 的 状态 
将 自动 更 新 。 
版 本 / 
里 程 碑 
Subversion | 提交 | 
Git 




















配置 完成 后 ， 在 提交 记录 中 输入 如 下 内 容 即 可 进行 关联 。 


TEAMDEV-31 
缺陷 管理 功能 和 版 本 管理 的 关联 方法 。 未 完 ， 这 部 分 结束 后 前 半 部 分 结束 。 


如 图 4.15 所 示 ， 问 题 票 和 代码 修改 关联 起 来 了 。 并 且 ， 从 代码 到 问 
题 票 的 链接 也 如 图 4.16 这 样 建立 起 来 了 。 


图 4.15 关联 问题 票 和 代码 修改 


约 30 页 


显示 全 部 只 显示 注释 




















- 译 论 
2013/07/15 20:39 Ln) ikeda_t 期 限 日 : 2013/06/30 -> 2013/07/21 
2013/07/28 20:39 Ln) ikeda t 5 | 引用 | 编辑 | 删除 会 


o 提交 : 166f67e59f 





TEAMDEV-31 写 了 工具 的 介绍 


2013/08/13 01:07 Ln) ikeda_t st | 引用 | 编辑 | 删除 便 


o 提交 :55aab31b67 ”( 向 teamdev 的 master 进行 Push ) 
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图 4.16 ”从 代码 到 问题 票 的 链接 


时 Repository | teamdev | Y | | 从 Tree:55aab31b67 | ” | | | Fles | Commit 历 史 i 


修改 55aab31b67 合 于 




















上 一 次 更 新 ”2013/08/13 ”01:05 ( 12 天 前 ) 
更 新 者 ”全 外 ikeda t 


评论 TEAMDEV-31 
缺陷 管理 功能 和 版 本 管理 的 关联 方法 。 未 完 ， 这 部 分 结束 后 前 半 部 分 结束 。 





commit 会 影响 路 径 名 字 


修改 ， chapter-3.md 团 | 显示 差异 人 历史 纪录 占用 浏览 器 直接 打开 F 











e@…… Backlog 和 GitHub 的 关联 


Backlog 公开 在 GitHub 的 Service Hooks 中 ， 所 以 和 GitHub 的 关联 
也 是 非常 容易 的 (图 4.17 )。 


图 4.17 GitHub 的 Service Hook ( Backlog ) 











Api Url 


User Id 





Update settings 


Backlog 


Backlog is a project management, hosting service. 
http://backiogtool.com, http://www.backlog.jp (Japanese) 


Install Notes 


1. apl_url is a API URL. e.g. if the Space ID is example, then the api_url will be 
https /iexample.backlog.jp/XML-RPC or 
https /fexample.backlogtoo.com/XML-RPC 

2. User_ id and password - user_id and password of a Backlog user that can 
post comment and update issue. 


You can specify issue keys (e.g9. DORA-1) and status keywords (#fixed, 
#closed) to change issue status (Resolved, Closed). 
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4.3.6 ”Git 自 市 的 Hook 的 使 用 方法 


使 用 像 GitHub 和 Backlog 这 样 的 系统 ， 缺 陷 管 理 系 统 和 版 本 管理 系 
统 之 间 的 关联 的 确 比 较 容易 。 但 因为 无 法 定制 Git 自身 ， 所 以 自由 度 和 
灵活 度 方面 还 是 受到 了 限制 。 之 前 提 到 的 系统 大 部 分 只 公开 了 Git 的 服 
务 需 端 Hook 中 的 Post-receive Hook， 并 没有 公开 所 有 的 Hook。 

目 己 搭建 Git 服务 需 的 话 ， 束 能 够 使 用 Git 所 提供 的 所 有 Hook。 在 
Git 的 代码 库 的 .git/hooks/ 目录 下 ，Git 提供 了 许多 分 别 运行 在 服务 器 端 
以 及 客户 端的 Hook。 该 目录 下 存放 有 默认 文件 名 为 *.sample 的 示例 脚 
本 ， 以 此 文件 为 样本 进行 开发 ， 可 以 写 出 各 种 各 样 的 Hook 。 








QD) 详细 内 容 请 参考 Git 的 文档 。http://git-sem.com/book/zh/ 自 定义 -Git-Git 挂钩 。 
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4.4 新 功能 开发 、 修 改 bug 时 的 工作 流程 


缺陷 管理 系统 和 版 本 管理 系统 关联 后 ， 新 功能 开发 /修改 bug 时 的 
工作 流程 如 下 。 本 节 以 JIRA 缺陷 管理 系统 、Git ( GitHub ) 版 本 管理 系 
统 为 例 来 进行 说 明 。 


@@ 建立 问题 票 
@ 指定 责任 人 
开发 

@ 提交 

全 Push 到 代码 库 


4.4.1 工作 流程 





seeeeeeeeeeeeeseeeeseseeeeseeeeseeeeseeeeseseeeeseeeseeseeeeseeeeeeseseeeeseeseeeeseeseeeseeeseeeeeseeeeseeeeeeeeseeeseeeeseeeeeeeeee 


@.………… @@ 建立 问题 票 


首先 根据 问题 内 容 建 立 问 题 票 ( 图 4.18 )。 


图 4.18 ”建立 问题 票 












































(ee pa-techconsul / PATECHCONSUL-829 
i sn » ~ 
之 9 邮件 没有 被 发 送 
2 Edit Assign Comment LogWork More Actions ~ Start Progress Resolvelssue Workflow ~ 四 Share ®Viewsr 
Details People 
Type: 轿 Bug Status: 晶 Open Assignee: Takafumi Ikeda 
Priority: 会 Major Resolution: Unresolved Reporter: Takafumi Ikeda 
Component/s: None 
Vote (0) 全 Watching (1) 
Labels: None 
ee Dates 
Description 
A A Created: Today PM 2:09 
申请 时 本 来 应 该 发 送 的 邮件 没有 发 送 。 Updated: Today PM 2:09 
Tempo 
二 Collaborators 中 
01/Nov/13 - 30/Nov/13 4 Curent 上 Report 宇 团 2 Log Work 
Date Descriptior Worked Agile 
View on Board 
Activity 
All | Comments | Work Log History Activity ”Transitions Summary Commits 
There are no comments yet on this issue. 
Comment 
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作业 。 





为 了 实现 或 修改 功能 ， 对 代码 进行 修改 并 提交 。 这 时 要 在 提交 记录 
中 添加 问题 票 的 票 号 。 不 同 缺 陷 管 理 系统 对 应 的 提交 记录 格式 可 能 有 所 
不 同 ，JIRA 的 提交 记录 如 下 。 


[#PATECHCONSUL - 829] 修改 了 发 送 邮 件 的 bug 

















en @ Push 到 代码 库 

在 将 提交 的 内 容 Push 到 代码 库 (图 4.19 ) 的 同时 ， 系 统 会 在 关联 
的 问题 票 中 添加 提交 的 链接 ( 图 4.20 )。 这 样 问题 票 和 提交 之 间 的 关联 
就 建立 起 来 了 ”。 





已 上 一 一 
图 4.19 代码 库 的 提交 记录 
sitory Search or type a command ( 
和 TechConsulting / CoolApp BUnwatchv 8 让 Star 0 全 Fork 0 
$B branch: master ” ”CoolApp / Commits 
《》 
Nov 10, 2013 
[#PATECHCONSUL - 829] 修改 了 发 送 邮件 的 bug 44530a7786 » oy 
b takafumi-ikeda authored 15 minutes ago 


Browse code 中 门 


init 
Ln takafumi-ikoda authorod 16 minutos ago 


Ln firet commit e925d7f9d5 
人 
Iakafurmi-ikeda auhored 43 minutes ago Browse code 中 








Lh 





QD) 在 传统 的 项 目 管理 中 ， 由 项 目 经 理 来 指派 合适 的 开发 人 员 。 而 在 敏捷 开发 的 团队 
中 ， 则 是 开发 人 员 自行 建立 问题 票 ， 再 将 问题 票 指派 给 自己 。 特 别 是 采用 Scrum 
的 团队 开发 ， 问 题 票 建立 时 负责 人 一 栏 是 空白 的 ， 在 每 天 的 例会 (展会 ) 上 由 开 
发 人 员 自 己 举 手 认 领 问 题 票 。 

”在 这 个 例子 中 没有 对 提交 时 的 提交 记录 进行 检查 ， 因 此 即使 忘记 在 提交 记录 中 添 
加 问题 票 号 也 能 够 顺利 提交 。 如 果 希 望 系 统 强 制 要 求 输入 问题 票 号 的 话 ， 可 以 使 
用 版 本 管理 系统 提供 的 Hook 机 制 ， 在 提交 时 对 是 否 记 载 了 问题 票 号 进行 检查 。 
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图 4.20 ”在 问题 票 中 添加 链接 


六 pa-techconsul / PATECHCONSUL-829 
”邮件 没有 被 发 送 


2 Edit Assign Comment LogWork More Actions ~ Start Progress < Resolve lssue Workflow 





r Details 
Type: [@ Bug Status: 呢 Open 
Priority: 会 Major Resolution: Unresolved 
Component/s: None 
Labels: None 

rr Description 











申请 时 本 来 应 该 发 送 的 邮件 没有 发 送 。 




















Tempo 
01/Nov/13 - 30/Nov/13 4 Curent Repor 和 宇 团 2 Log Work 


Date Description Worked 
- Activity 

All Comments Work Log History Activity Transitions Summary | Commits 

可 takafumi-ikeda Today PM 2:44 


[#PATECHCONSUL - 829] 修改 了 发 送 邮件 的 bug View full commit 加 


27 master 


src/main/java/com/gmail/ikeike443/App.java 











在 介绍 Pivotal Tracker 和 Backlog 时 已 经 提 到 过 ， 在 提交 记录 的 问 
题 票 号 中 插入 Fixs 、Fixed、Delivered 等 特定 的 命令 语句 的 话 ， 在 
添加 链接 的 同时 还 能 改变 问题 票 的 状态 。 命 令 语句 的 格式 以 及 与 之 对 应 
的 状态 变化 ， 各 个 缺陷 管理 系统 不 尽 相 同 ， 请 参考 相应 的 帮助 文档 。 
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4.5 回答 “那个 bug 是 什么 时 候 修 正 的 ”的 问题 





团队 开发 过 程 中 经 常会 从 销售 、 顾 问 或 者 客户 那里 收 到 “ 那 时 的 那 
个 bug， 是 什么 时 候 、 在 哪个 版 本 修正 的 ?” 这 样 的 调查 要 求 。 

这 时 ， 如 玉 已 经 天 联 了 缺陷 省 理 系 统 和 版 本 省 理 系统 的 话 ， 束 有 可 
能 顺利 地 找 出 答案 。 





4.5.1 Pivotal Tracker 的 例子 





首先 以 Pivotal Tracker 为 例 进 行 说 明 。 
@…… 用 记忆 中 残留 的 关键 字 进 行 检 索 


如 果 在 收 到 这 样 的 调查 要 求 时 能 够 得 知 问题 票 号 ， 那 束 不 必 下 去 查 
找 问 题 票 了 。 但 如 采 无 法 获得 ， 那 就 只 能 通过 调查 内 容 中 模糊 的 信息 以 
及 负责 人 模糊 的 记忆 来 找 出 问题 票 。 














首先 使 用 缺陷 管理 系统 的 检索 功能 找 出 问题 票 (图 4.21 )。 这 里 用 
关键 字 “ 一 并 下 载 ” 进 行 全 文 检索 。 
图 4.21 用 Pivotal Tracker 进行 关键 字 检 索 
Pp | V 性 T A L 1 R A © K E R PROJECTS DASHBOARD REPORTS HELP TAKI 


ContentsPublisher EventSuite LeadSegmentEngine My Sample Project Other Products SI SSS 














CURRENT BACKLOG ICEBOX EPICS MORE Y PROJECT Y STORIES Y ADD STORY + 上 插口 一 下 






show 1 matching done story 


康 奥 ) 












才 =) 并 下 载 时 文件 名 中 竟 入 了 多才 的 文子 
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e…… 通过 问题 票 查找 代码 修改 


找到 的 问题 票 中 记载 有 指向 GitHub 修改 记录 的 链接 ( 图 4.22 )。 
图 4.22 ”修改 记录 的 链接 








jv | 批量 下 载 时 的 文件 名 中 混 有 多 余 的 文字 | | 





| | Save | Close 


























STORY TYPE 请 Feature 

POINTS a 

STATE | Accept | Delivered v 

| REQUESTER 康 树 奥 村 了 

OWNER 康 树 奥 村 了 

BUGZILLA ID 24127 图 
Requested 15 May 2013, 8:09am 








DESCRIPTION 
| 通过 批量 下 载 下 载 的 文件 名 中 混 有 多 余 的 文字 


























LABELS 
| Vr 
| TASKS 
| Add a task Wn aaa | 
ACTIVITY All Activity 
Commit by buster84 24 May 2013, 6:27pm 
让 [Fixed #49891579 #49891623 #49891631] Create report 
| file after syncing data. 


https“//github.com/Shanon/DeeElle/commit 
/201aa967f01653c6f2a8e3c836e3f455541524ba 











点 击 链接 就 会 跳 转 到 GitHub 对 应 的 提交 页 面 ， 在 此 可 以 查看 提交 
代码 的 差分 对 比 ( Diff ) (图 4.23 )。 
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图 4.23 ”GitHub 的 修改 记录 








OO = This reposltory * Search ortype acommand D 奶 Explore Gist Blog Help 机 ikeike443 本 4 | 
PAIVATE Shanon / DeeElle 门 PullRequest 作 Watch - 育 Star 0 灶 Fork 2 
Code Network Pull Requests 0 Issues 2 Wiki Graphs Settings 
iea: 201aa967f0 - Files Commits Branches 豆 Tags 而 
[Fixed #49891579 #49891623 #49891631] Create report file after syncin... Browse code 
-9 data. 
VB master 
buster84 authored 6 days ago 1 parent 6396428 commit 28laa967f@1653c6f2a8e3c836e3f455541524ba 
+| Showing 15 changed files with 224 additions and 151 deletions Show Diff Stats 


4 加 要 本 加 app/Global .scala View file @ 201aa96 


ee -19,6 +19,8 88 import org.joda.time.DateTime 
import org.joda.time.Period 
import org.joda.time.Duration 


+import models.output.ReportHandler 
+ 
object Global extends Globalsettings { 


Var cancellable :Cancellable = null 

26,6 +28,7) ta object Global extends GlobalSettings 1{ 
override def onstart(app: PLLOation) = { 

val something = super.onstart!(app) 


+ Val tmpDirectory = Play.current.configuration.getstring("file.tmpdirectory").getOrElse("/tmp/dl") 
val jobName = "deeElle jobi" 
val span = Play.current .configuration.getIint("job.schedule.span").getOrElse(60 * 24) 
val limit = Play.current .configuration.getIint("job.schedule.limit").getorElse(1i) 
6 +54,7 ee object Global extends Globalsettings + 
"summaryreport save”" -> DataBuilder.saveSummaryreport (prefix)) 
DataBuilder.updateTargetCollectionNames{(prefix) 
+ ReportHandler.createReportFiles(tmpDirectory, prefix) 


Logger.infol(Serialization.write(result)(net.liftweb.json.DefaultFormats)) 


} 


215 回回 硬 吾 app/controllers/Main.scaloa View file @ 201aa96 


3 +1,7 fg 
package controllers 





import models._ 
+import models.output.ReportHandler 


这 样 就 查 到 了 对 应 的 代码 提交 纪录 。 接 大 只 要 查 出 这 个 提交 反映 到 
了 哪个 发 布 版 本 “， 调 查 就 基本 可 以 结束 了 。 
根据 运用 方式 的 不 同 ， 例 如 在 master 分 文 适当 地 打上 发 布 标签 并 进 
行 发 布 的 情况 下 ， 只 需要 确认 提交 是 否 反 映 到 master 分 文 ， 束 能 够 判断 
是 否 反 映 到 某 个 版 本 的 发 布 中 了 。 








4.5.2 Backlog 的 例子 





再 举 一 个 Backlog 的 例子 。 这 次 版 本 管理 系统 使 用 Subversion。 


GD 通常 以 标签 的 形式 保存 。 
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在 Backlog 的 画面 上 设置 检索 条 件 ， 对 问题 票 进 行 检 索 (图 4.24 )。 
这 里 以 “程序 令 牌 ”作为 关键 字 来 检索 。 


图 4.24 ”检索 问题 票 


查询 课 十 《所 有 项 目 范围 内 ) 





国 亚 丽 条件 : v 项 目 = GR Guide Translation Y 杖 态 = 六 处 理 处 理 中 处 理 实 毕 落 采 

















失态 Y 除 首 采 之 外 Ed 版 本 









































里 程 牢 种 赤 
未 设置 未 设置 未 设置 区 Guide Translation 
Git Guide Translation Git Guide Translation Git Guide Translation Tue 中 
| Deher 
代 先 级 责任 省 和 提交 有 有 我 铺 素 瑶 由 文件 
3 | 和 a 四 eho 文件 
高 未 设置 a baba 未 设置 | 回 共 剖 文 件 树 接 
中 boby | Eddie Yon 已 表决 国 
区 Eddin lan hayachidrulab 无 各 名 进 a 
> 无 网 | 
hayashgmultb 区 这 py 加 辫子 巢 业 外 
x | 
沽 际 证 衣 条 件 
加 地 综 妆 京 之 外人 昌 是 ) 【其 此 条 件 坦 询 
共 83 个 课 蝴 , 显示 1- 20 个 [2345 下 - 丰 > 蓓 一 次 性 更 新 所 有 项 过 出 床 的 理 蓝 ”亲自 定义 亚 调 结果 ”的 CSV ”的 Excel 名 打印 去 用 页 面 
| 由 | KEY | 5 优 肖 | 坟 w 期 | 
GIT_TRANS-19 Reyewinrot_1 





2014109107 





开 疝 日 |】 冉 昌 | 祷 计 全 9 时 间 中 吧 ) 。 |】 3 全 册 和 周 tlej 。|】 更 新 日 类 (| 提交 南 。 | 。 六 人 本 呈 休 | 文件 | 
20141016 Jo Woh 请 素 


确认 找到 的 问题 标的 内 容 〈 图 4.25 )。 


图 4.25 ”问题 票 的 内 容 





SSAPI-21 岛 | 提交 日 期 : 2011/12/15 15:10:28 | 开始 日 : 2011/12/15 | 期限 日 : 2011/12/15 


给 SsApiCommon 添加 重新 取得 Token 的 功能 


Task 优先 级 ” 中 
结束 理由 
状态 ”结束 
里 程 碑 责任 者 ”【 shanon 】 池 田 尚 史 
预计 使 用 时 间 (小 时 ) 2 实际 使 用 时 间 ( 小 时 ) 


详细 on) 【 shanon 】 池 田 尚 史 St 





显示 全 部 ” 只 显示 注释 (3) 


2011/12/15 18:18 on) 【 shanon 】 池 田 尚 史 号 | 引用 | 编辑 | 删除 会 














9 状态 : 未 处 理 -> 处 理 完毕 
2 提交 : r231 


SSAPI-21 
添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
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问题 票 中 有 提交 记录 的 链接 ， 点 击 链 接 就 能 确认 提交 的 内 容 (图 
4.26 )。 


图 4.26 ”提交 记录 列表 
修改 r231 本 





<< 上 一 个 修改 (r230 ) 下 一 个 修改 ( r232 ) >> 





修改 概要 





更 新 时 间 2011/12/15 18:18 
更 新 者 Ln | 【 shanon 】 池 田 尚 史 st 
评论 ”SSAPI-21 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
#fixed 











eh 


























Commit 会 影响 路 径 名 字 












































异国 : ssApicommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Activity.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 




















修 履 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Application.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 





























有 耻 避 : SsApiCommonjtrunk/src/main/java/jp/co/shanon/ss/api/services/Session.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 


























喇 雪 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Visitor.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 






































修改 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorApplication.java |[ 显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 







































































修改 : SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorFile.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 


还 可 以 通过 Diff 来 比较 代码 的 内 容 (图 4.27 )。 
图 4.27 ”比较 代码 内 容 






















SsApiUtiljava : r225 写 r231 四 差分 
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这 样 就 通过 Backlog 将 从 调查 到 代码 的 修改 这 一 整个 过 程 串 联 起 来 
了 。 接 着 也 同样 只 需要 调查 清楚 这 些 提 交 反 映 到 了 哪个 版 本 的 发 布 中 就 
可 DT 了 
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4.6 回答 “为 什么 要 这 样 修改 ”的 问题 








在 4.5 节 中 ， 我 们 说 明了 根据 调查 查找 代码 修改 的 例子 。 而 在 团队 
开发 现场 还 存在 相反 的 、 从 代码 追溯 问题 票 的 情况 。 例 如 在 本 地 编译 失 
败 或 者 单元 测试 失败 的 情况 下 ， 就 需要 通过 缺陷 管理 系统 和 版 本 管理 系 
统 的 提交 记录 ， 追 查 出 造成 失败 的 问题 票 。 

但 是 这 个 功能 的 前 提 条 件 是 必须 由 单个 系统 统一 提供 缺陷 管理 和 版 
本 管理 。 例 如 Backlog 会 日 动 地 同步 生成 从 提交 记录 到 问题 票 的 链接 ， 
能 够 简单 地 从 代码 修改 链接 到 问题 票 。 从 图 4.26 中 可 以 看 出 ， 提 交 记 录 
也 添加 有 问题 标的 链接 。 

Trac 和 Redmine 基本 与 Backlog 一 样 。GitHub 会 在 提交 记录 中 目 动 
添加 自身 的 Issue 功能 的 链接 。 上 述 以 外 的 缺陷 管理 系统 基本 上 都 无 法 
目 动 添加 链接 。 在 这 样 的 情况 下 ， 可 以 采用 复制 提交 记录 的 版 本 号 并 业 
贴 到 所 使 用 的 缺陷 管理 系统 中 等 方法 来 应 对 。 虽 然 稍 显 原始 ， 但 比 起 没 
有 任何 信息 、 完 全 无 从 调查 的 状况 来 说 还 是 要 好 很 多 。 
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4.7 ”本章 总 结 


综 上 所 述 ， 通 过 关联 缺陷 管理 系统 和 版 本 管理 系统 ， 代 码 的 可 追溯 
性 有 了 很 大 的 提高 。 

本 章 介 绍 了 包括 免费 /收费 在 内 的 各 类 缺陷 管理 系统 。 最 近 几 乎 所 
有 的 缺陷 管理 系统 部 提 供 了 和 版 本 管理 系统 进行 关联 的 功能 ， 这 里 对 关 
联 的 方法 也 进行 了 说 明 。 

通过 关联 缺陷 管理 系统 和 版 本 管理 系统 并 加 以 有 效 地 利用 ， 就 能 够 
知道 什么 时 候 、 谁 、 进 行 了 什么 操作 这 一 连 串 的 信息 ， 并 且 还 能 加 快 发 
生 问 题 时 查找 原因 的 速度 。 

这 和 既 不 使 用 缺陷 管理 系统 也 不 和 版 本 管理 系统 进行 关联 的 情况 比 
起 来 可 以 说 是 天 壤 之 别 。 请 回忆 一 下 第 2 章 中 的 案例 分 析 。 在 那个 案例 
中 ， 收 到 通过 邮件 发 来 的 调查 请 求 ， 却 无 法 检索 版 本 管理 系统 的 提交 记 
录 ， 即 便 确 认 了 提交 记录 也 不 知道 这 样 修改 的 理由 。 

第 2 草 的 案例 分 析 中 还 有 个 例子 是 : 根据 收 到 的 调查 请 求 进行 的 修 
改 被 其 他 开发 人 员 用 别 的 提交 履 盖 把 了。 如 采 关 联 了 缺陷 管理 系统 和 版 
本 管理 系统 的 话 ， 就 能 从 提交 记录 找 出 对 应 的 问题 票 ， 进 而 承 应 该 能 知 
过 进行 如 此 修改 的 绿 由 。 

但 即使 这 样 还 是 党 得 有 所 不 足 ， 并 不 是 说 仅仅 找 出 有 问题 的 提交 ， 
并 调查 出 作为 提交 原因 的 问题 聚 就 足够 了 。 不 能 一 开始 束 阻 止 这 样 有 问 
题 的 提交 吗 ? 不 能 在 每 次 提交 时 都 对 其 正确 性 进行 检查 吗 ? 

如 采 能 够 实现 上 述 机 制 ， 就 能 在 更 早 的 阶段 确保 提交 的 正确 性 ， 开 
发 的 质量 也 会 相应 地 提高 。 这 样 的 机 制 就 是 将 在 第 5 章 进 行 说 明 的 CI。 












































-一 专栏 ”缺陷 管理 、bug 管理 以 及 需求 管理 
本 和 草 主 要 讲述 了 用 缺陷 管理 系统 对 开发 中 的 任务 进行 管理 的 相 
关内 容 。 而 在 任务 确立 之 前 的 阶段 ， 软 件 开 发 团队 还 有 必要 对 课题 
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管 
缺陷 管理 系统 能 够 覆盖 哪些 范围 呢 ? 或 者 说 应 该 覆盖 哪些 学 
围 呢 ? 

这 里 我 们 借鉴 敏捷 开发 方法 论 之 一 的 Scrum 的 部 分 术语 ， 将 课题 
分 为 epic、story、task、bug 这 4 类 ， 并 分 别 对 它们 的 粒度 进行 说 明 。 


epic ( 很 大 的 需求 、 跨 部 门 的 课题 等 ) 

可 以 称 为 epic 的 大 粒度 的 课题 一 般 有 如 下 特征 。 不 熟悉 epic 这 
个 术语 的 话 可 以 回想 一 下 系统 需求 确定 下 来 之 前 的 需求 定义 阶段 ， 
这 样 会 比较 容易 理解 。 


@ 和 工程 师 不 相关 的 事情 占 多 数 

@ 以 确定 优先 顺序 为 主要 目的 ， 因 此 以 一 览 表 的 形式 呈现 出 来 
很 重要 

@ 刚 开 始 时 多 处 于 模糊 的 状态 ， 因 此 不 适合 采用 固定 的 格式 ， 
最 好 是 能 够 灵活 修改 的 

@ 方便 多 人 进行 编辑 、 共 享 


这 样 的 粒度 下 一 般 会 使 用 电子 表格 工具 。 因 为 工程 师 之 外 的 团 
队 成 员 也 能 够 直观 地 进行 编辑 ， 所 以 是 最 简便 的 方法 。 如 果 考 虑 到 
共享 和 同时 编辑 的 问题 ， 最 好 使 用 GoogleDocs 这 样 的 在 线 工 具 。 


epic 的 内 容 示例 : 
e@ 构筑 开拓 新 市 场 用 的 系统 
@ 为 每 个 客户 准备 信息 中 心 ， 提 供 对 其 所 使 用 的 产品 的 统计 信 
息 和 用 户 的 访问 情况 进行 分 析 的 功能 


story ( 具体 的 需求 ， 和 功能 性 需求 或 规格 程度 相近 ) 

冰 为 stroy 的 粒度 有 如 下 这 些 特征 。 它 在 Scrum 中 表示 为 用 户 
带 来 的 价值 。 如 果 对 Scrum 不 熟悉 的 话 可 以 理解 为 程度 上 近似 于 具 
体 的 功能 要 求 或 规格 。 


@ 一 般 多 由 产品 的 负责 人 编写 ( Scrum 中 的 用 语 是 product owner ) 
e@ 根据 团队 或 项 目的 情况 ， 可 以 由 工程 师 以 外 的 成 员 编写 ， 也 
可 以 由 程序 员 编 写 
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@ 需要 进行 状态 管理 
@ 最 好 开始 和 代码 建立 关联 
@ 负责 人 可 以 是 多 人 也 可 以 是 一 个 人 


这 样 的 粒度 可 以 考虑 使 用 缺陷 管理 系统 进行 管理 。 关 系 到 多 个 
负责 人 的 大 型 story 的 话 需 要 再 想 想 办 法 。 

方法 之 一 束 是 先 建立 问题 票 再 分 割 为 子 任务 。 如 果 系 统 支 持 在 
问题 票 之 间 建 立 继承 关系 ， 可 以 直接 使 用 该 功能 ， 这 样 管理 起 来 也 
较为 方便 。 

根据 相关 人 员 的 数量 ， 也 可 能 是 使 用 电子 表格 工具 进行 管理 更 
为 理想 。 至 于 应 该 如 何 确定 缺陷 管理 系统 和 电子 表格 工具 的 分 界线 ， 
每 个 项 目 、 每 个 团队 都 有 目 己 不 同 的 标准 ， 很 难说 哪个 是 最 好 的 ， 
请 根据 项 目的 实际 情况 探讨 合适 的 方法 。 

比较 常用 的 方法 是 以 团队 为 分 界线 。 如 果 课 题 涉 及 多 个 部 门 ， 
可 以 采用 电子 表格 工具 进行 管理 ， 等 具体 的 开发 内 容 确定 下 来 后 再 
由 各 部 门 自行 建立 问题 票 。 由 于 管理 方面 职责 明确 ， 因 此 较 大 的 开 
发 团队 多 采用 该 方法 。 


stroy 的 内 容 示例 : 
@ 为 了 体现 出 对 顾客 的 欢迎 ， 想 要 在 顾客 登录 时 根据 顾客 的 信 
息 显 示 欢 迎 或 其 他 消息 等 
@ 将 每 个 用 户 ID 的 用 户 访问 状况 ， 以 小 时 、 属 性 分 别 进行 统 
计 ， 并 且 支 持 在 信息 中 心 阅览 和 下 载 


task 
即 作 业 。 和 价值 没有 直接 关系 ， 但 如 果 不 完成 task 的 话 story 
的 完成 就 无 从 谈 起 。task 的 概念 应 该 还 是 比较 容易 理解 的 。 


@ 具体 的 作业 内 容 
@ 大 致 的 印象 是 story 下 关联 着 多 个 task 
@ 只 有 一 个 负责 人 


e@ 根据 内 容 确定 是 否 需要 和 代码 进行 关联 





task 应 该 采用 缺陷 管理 系统 进行 管理 。 如 果 系 统 支持 问题 票 之 
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间 有 继承 关系 ， 或 者 允许 在 问题 票 下 定义 附属 问题 票 ， 可 以 将 story 
定义 为 问题 票 ， 将 task 定义 为 子 问题 票 或 者 附属 问题 票 。 


task 的 内 容 示例 : 
@ 初始 化 系统 
@ 写 单元 测试 


bug、 故 障 人 处理 、 调 查 
即 QA 部 门 发 来 的 bug 报告 、 故 障 的 处 理 以 及 顾客 的 咨询 等 。 


@ 程度 上 和 task 相近 
@ 通常 由 单个 开发 人 员 负 责 
@ 需要 和 代码 进行 关联 


应 该 作为 缺陷 管理 系统 的 管理 对 象 。 至 于 是 以 task 的 粒度 进行 
管理 还 是 以 story 的 粒度 进行 管理 ， 可 以 根据 项 目 或 团队 的 具体 情况 
选择 合适 的 方式 。 

在 bug 数量 很 多 的 情况 下 ， 可 以 将 bug 管理 和 其 他 的 问题 票 区 
分 开 ， 使 用 其 他 的 系统 进行 管理 。 这 也 是 一 种 方法 ， 但 这 样 的 话 管 
理 上 就 会 变 得 复杂 ， 所 以 并 不 推荐 。 应 该 尽 可 能 地 在 同一 缺陷 管理 
系统 下 对 story 和 bug 进行 管理 。 


总 结 

至 此 我 们 一 起 看 了 课题 的 分 类 和 管理 方法 。 这 样 的 分 类 方法 是 
灵活 的 ， 并 非 一 成 不 变 的 。 如 果 团 队 有 上 自己 一 贯 采用 的 分 类 方法 也 
完全 适用 。 

能 够 肯定 的 是 : 缺陷 管理 系统 适用 于 目的 以 及 内 容 在 一 定 程度 上 
确定 下 来 之 后 的 管理 ， 不 适合 在 此 之 前 的 那些 比较 模糊 的 、 不 确定 
的 事物 的 管理 。 在 这 个 阶段 ， 使 用 电子 表格 工具 等 形式 不 固定 的 工 
具 进 行 管理 会 比较 好 。 

表格 工具 和 缺陷 定理 系统 的 分 界线 取决 于 相关 的 部 门 数 或 人 数 ， 
另外 ， 在 负责 的 部 门 发 生变 化 时 切换 到 缺陷 管理 系统 也 是 可 以 的 。 

疫 有 必要 只 使 用 一 种 工具 ， 同 样 ， 也 疫 有 必要 拘泥 于 一 种 定义 ， 
我 们 要 做 的 应 该 是 摸索 出 一 套 最 适合 自己 团队 的 方法 。 
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5.1 CI ( 持续 集成 ) 


5.1.1 什么 是 Cl ( 持续 集成 ) 





团队 开发 中 最 重要 的 工作 是 什么 ?是 编码 等 开发 工作 ?还 是 测试 工 
作 ? 当然 这 些 工 作 都 是 团队 开发 中 基本 且 重 要 的 工作 。 但 是 为 了 顺利 地 
推进 由 多 人 参与 的 开发 以 及 测试 ， 最 重要 的 基础 是 “集成 ”。 











@…… 集成 ( integration ) 


将 各 个 成 员 的 工作 成 果 集 中 到 一 处 进行 集成 ， 直 到 形成 可 以 运行 的 
系统 ， 各 个 成 员 的 开发 工作 才 有 了 意义 ， 才 能 进行 测试 ， 最 终 才 能 以 产 
品 的 形式 癌 顾 客 提供 价值 。 

集成 ， 具 体 来 说 就 是 像 下 面 这 样 执行 build 和 测试 的 流程 。 

















e@ 将 所 有 的 代码 集中 到 一 处 

e@ 设置 依赖 程序 库 等 的 路 径 

@ 必要 的 情况 下 进行 编译 

e@ 进行 数据 库 构建 和 数据 加 载 

e@ 必要 的 情况 下 对 中 间 件 进行 配置 和 启动 

e@ 实施 单元 测试 、 集 成 测试 、 用 户 验 收 测 试 等 


e@…… 持续 地 进行 集成 就 是 CI 


将 这 些 集成 处 理 流程 持续 地 执行 ， 束 是 CI ( Continuous Integration ， 

、 GD 

持续 集成 ) 。 
QD 如 果 从 一 开始 就 能 实现 之 前 提 到 的 所 有 集成 处 理 流程 的 自动 化 ， 这 个 自然 是 最 理 
想 的 。 但 这 将 耗费 大 量 的 时 间 和 和 精力， 因此 没有 必要 将 实现 所 有 集成 处 理 的 自动 


化 作为 目标 。 不 仅仅 是 CI， 类 似 的 实践 的 效果 以 及 对 应 的 开销 都 需要 进行 权衡 。 
因此 ， 可 以 先 从 自己 项 目 所 必要 的 处 理 开始 实现 自动 化 。 
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原本 CI 是 作为 敏捷 开发 方法 之 一 的 极限 编程 (eXtreme Programming, 
XP ) 的 实践 项 目 被 提出 的 。 其 实 可 以 室 不 过 分 地 说 ， 在 以 高 品质 、 快 速 
地 提供 有 价值 的 软件 为 目标 的 敏捷 开发 中 ，CI 是 最 基本 、 最 重要 的 
实践 。 

在 以 前 的 瀑布 模型 开发 "中 , 一 般 要 等 到 所 有 的 开发 工作 都 结束 后 ， 
到 测试 阶段 时 才 开 始 着 手 进行 集成 。 

想必 读者 都 有 过 这 样 的 经 验 : 直到 测试 阶段 才 开 始 实 施 集 成 ， 往 往 
会 出 现 程序 库 缺 失 、 数 据 库 构 建 失 败 、 编 译 无 法 通过 等 问题 。 集 成 的 实 
施 越 迟 、 代 码 的 量 越 大 ， 就 越 困 难 。 

要 集成 多 名 团队 成 员 的 作业 内 容 更 是 一 件 相 当 有 麻烦 的 工作 ， 因 此 往 
往 容 易 往 后 拖延 。 但 是 只 有 经 过 了 集成 这 个 步 又， 程序 才能 作为 一 个 整 
体 开始 运行 。 在 进行 集成 之 前 ， 确 认 产 品 是 否 满足 需求 ， 是 否 有 奇怪 的 
bug 等 检 证 工作 也 无 法 开展 。 可 见 拖 延 并 不 是 一 个 好 办 法 。 

不 将 复杂 的 集成 处 理 推 后 ， 而 是 在 开发 中 时 篆 地 进行 集成 处 理 ， 由 
此 来 排除 软件 开发 中 的 复杂 性 ， 这 就 是 CI 的 思考 方式 。 



































5.1.2 ”使 开发 敏捷 化 


e…… 瀑布 式 开发 的 开发 阶段 

过 去 的 瀑布 式 开发 是 在 需求 定义 完成 后 进行 设计 、 开 发 ， 之 后 再 依 
次 进行 单元 测试 、 集 成 测试 、 用 户 验收 测试 ， 因 此 到 开始 正式 提供 服务 
的 开发 周期 容易 拖 得 很 长 (图 5.1 )。 








QD 将 系统 的 开发 流程 分 为 分 析 、 设 计 、 编 码 、 测 试 、 部 署 等 阶段 ， 并 按 上 述 顺 序 依 
次 进行 作业 的 开发 模型 。 
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开发 全 部 完成 后 才 开 始 单元 测试 ， 这 就 意味 着 如 果 开 发 周期 为 3 个 
月 ,那么 多 名 开发 人 员 为 期 3 个 月 所 编写 的 代码 直到 单元 测试 阶段 才 第 
-次 集中 到 一 处 进行 build。 在 此 之 后 还 有 集成 测试 和 用 户 验 收 测试 。 

从 图 5.1 就 能 看 出 ， 从 需求 定义 确定 下 来 ， 到 用 可 以 实际 运行 的 程 
序 进 行 验证 ， 这 期 间 的 时 间 间 隔 非 党 大 。 甚 至 会 有 在 项 目 临 近 结 束 时 还 
需要 重新 返工 的 风险 。 

瀑布 式 开发 是 确保 各 阶段 的 正确 性 之 后 再 开始 下 一 阶段 ， 因 此 理论 
上 在 进入 下 一 个 阶段 后 就 不 应 该 返回 上 一 阶段 。 但 实际 上 ， 很 多 事情 只 
有 在 目睹 运行 的 系统 后 才 会 知道 。 正 如 读者 所 知 ， 很 多 采用 瀑布 式 开 发 
的 项 目 直 到 临近 结束 还 在 修改 需求 、 重 新 编码 并 重新 测试 。 











e@…… 敏捷 开发 的 开发 阶段 


与 之 相对 ， 以 Scrum 为 代表 的 敏捷 开发 采取 了 相反 的 方式 ， 即 以 
sprint 这 样 较 短 的 周期 来 循环 实施 设计 开发 、 单 元 测试 、 集 成 测试 、 用 
户 验 收 测试 ( 图 5.2 )。sprint 的 周期 因 项 目 而 寞 ， 通 第 多 设 定 为 两 周到 1 
|e 
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图 5.2 敏捷 开发 的 开发 阶段 


厂 人 


人 和 八 /\ /NN 


两 周 两 周 两 周 














J 
Scrum 以 sprint 为 周期 提交 工作 成 果 ， 并 以 sprint review 这 样 的 流 
程 对 工作 成 果 进 行 审查 ， 给 出 反馈 ， 并 反映 到 下 一 个 sprint 的 作业 中 。 
以 正式 提供 服务 为 目标 ”, 重复 上 述 过 程 。 上 述 流程 可 以 理解 成 将 瀑布 式 
开发 中 从 需求 定义 到 用 户 验 收 测试 的 过 程 浓缩 到 为 期 两 周 的 Sprint 内 进 
行 “。 这 样 的 方式 能 够 及 早 地 检查 出 产品 和 需求 之 间 的 差异 ,调整 的 机 会 
也 会 相应 增加 。 
CI 十 敏捷 开发 的 基础 中 最 重要 的 实践 。sprint 中 的 工作 成 果 通 第 是 
和 “可 以 确认 满足 某 种 需求 的 可 运行 的 程序 ”， 进 一 步 说 就 是 “可 以 判 
几 是 否 能 够 正式 投入 运营 的 可 运行 程序 ”。 要 在 短 短 两 周 的 时 间 内 制作 
出 可 以 运行 的 产品 ， 如 果 还 要 在 集成 上 花费 时 间 是 肯定 来 不 及 的 。 更 何 
况 是 到 了 sprint 的 后 期 才 开 始 集成 并 测试 ， 无 论 如 何 都 是 来 不 及 的 。 
此 就 需要 每 天 进行 开发 、 集 成 、 测 试 这 样 的 循环 ， 这 就 是 CI。 换 言 之， 
build 和 测试 的 自动 化 途径 将 是 至 关 重 要 的 。 



































QD) 进一步 来 说 ， 上 线 运营 与 其 说 是 终点 ， 倒 不 如 说 是 开始 。 如 果 能 在 上 线 后 持续 进 
行 Sprint， 反 复 地 改善 和 审查 ， 就 可 以 向 顾客 提供 更 多 的 价值 。 

@) 当然 要 在 两 周 内 实现 所 有 的 需求 是 不 可 能 的 。 因 此 要 排出 需求 的 优先 顺序 并 估计 
工 数 、 制 定 计 划 。 从 优先 度 高 的 项 目 开始 ， 按 顺序 投入 到 Sprint 开发 中 。 在 每 次 
的 Sprint review 中 检查 开发 状况 ， 并 根据 市 场 的 变化 ， 一 边 调整 优先 度 一 边 进 入 
下 一 个 开发 周期 ， 这 就 是 敏捷 开发 。 这 里 的 估计 工 数 和 制定 计划 是 敏捷 开发 中 最 
困难 、 同 时 也 是 最 有 趣 的 部 分 。 本 书 就 不 详 述 了 ， 有 兴趣 的 读者 可 以 参考 下 面 的 
文献 资料 。 
《敏捷 估计 与 规划 》 ( 美 ) Mike Cohn 著 ， 宋 锐 译 ， 清 华 大 学 出 版 社 ，2007 
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无 论 是 从 上 自动 化 集成 的 角度 还 是 从 其 他 角度 来 看 ，CI 都 是 非常 重要 
的 。 之 前 已 经 提 到 过 ，Scrum 以 sprint 周期 为 粒度 反复 进行 review 和 反 
僻 。 实 现 CI 的话， 编程 作业 和 目 动 化 测试 的 循环 就 能 粒度 更 细 、 运 转 
更 迅速 。 自 动 测试 的 结果 正 是 程序 是 否 正确 运行 的 反馈 。 

也 就 是 说 ， 如 图 5.3 所 示 ， 项目 整体 以 sprint 为 粒度 进行 反馈 ， 并 
这 样 不 断 循环 。 而 每 个 sprint 中 又 进一步 以 CI 为 粒度 进行 反馈 ,同样 进 
行 着 循环 。 这 样 就 构成 了 骸 套 的 结构 图 。 


图 5.3 ”sprint 和 CI 的 循环 


/pint st st 























、 
、 
、 





\ 一 


\ 


1 天 ~ 每 次 提交 时 1 天 二 每 次 提交 时 1 天 ~ 每 次 提交 时 











二 2 

以 这 样 的 粒度 快速 进行 反馈 的 循环 ， 就 能 够 在 快速 开发 的 同时 确 你 
产品 的 质量 ， 这 就 是 敏捷 开发 。 而 在 育 后 文 梯 着 敏捷 开发 的 驶 是 CI 这 
样 的 实践 。 
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需要 从 以 下 两 个 角度 出 发 来 思考 。 


e@ 成 本 效益 ( cost benefit ) 
e@ 市 场 变 化 的 速度 


一 般 而 言 ，bug 出 现 的 时 间 越 长 ， 修 改 该 bug 的 成 本 就 越 高 。 例 如 
使 用 刚刚 编写 的 代码 当场 进行 测试 ， 即 使 发 现 了 bug， 查 明 原 因 并 进行 
修改 也 是 比较 容易 的 。 

与 之 相对 ， 如 果 不 进 行 测试 直接 提交 代码 ，3 天 后 才 注 意 到 bug 的 
话 会 怎么 样 呢 ? 两 周 后 、1 个 月 之 后 会 怎么 样 呢 ? 那 时 所 写 的 代码 的 内 
容 可 能 已 经 记 不 太 清 了 ， 其 他 开发 人 员 也 可 能 对 该 代码 进行 过 提交 了 ， 
修改 bug 的 难度 将 大 大 提升 。 而 如 果 是 3 个 月 后 或 半年 后 才 发 现 ， 想 想 
就 觉得 非常 已 怖 了 。 

实现 build 和 测试 的 自动 化 ， 并 且 能 够 实施 CI 的 话 就 能 解决 这 个 问 
题 。 通 过 实施 CI， 提 交 之 后 就 能 立即 察觉 是 否 有 bug 产生 ， 修 改 bug 的 
成 本 将 大 大 降低 。 所 以 说 CI 的 实施 能 大 大 提高 成 本 效益 。 

这 里 所 说 的 成 本 主要 是 指 修改 bug 相关 的 经 济 方面 的 成 本 ， 除 此 之 
外 还 有 其 他 需要 注意 的 成 本 ， 例 如 可 维护 性 相关 的 成 本 。 

保持 代码 清晰 易 谈 、 添 加 功能 方便 ， 这 是 长 期 维护 产品 中 非常 重要 
的 。 不 仅 是 单纯 地 加 快 增加 新 功能 的 速度 所 带 来 的 经 济 方面 的 优点 ， 在 
保持 负责 维护 和 功能 开发 的 团队 成 员 的 精神 健康 以 及 提高 开发 效率 方面 


























Q) 这 里 虽然 是 说 近年 来 才 逐 渐 走 红 ， 事 实 上 CI 这 样 的 思考 方式 很 时 之 前 就 有 了 。 
比如 《程序 员 修 炼 之 道 》( Andrew Hunt、David Thomas 著 ， 马 维 达 译 ， 电 子 工业 
出 版 社 ，2011 年 ) 中 就 提 到 了 自动 化 测试 的 必要 性 ;Joel on Software ( Avram 
Joel Spolsky，APress，2004 年 ) 中 也 以 专栏 的 形式 介绍 了 自动 化 build 和 自动 
化 测试 对 提高 工作 效率 的 作用 。 近 年 来 随 着 相应 工具 的 出 现 ，CI 也 开始 逐渐 普 
及 了 。 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


148 | 第 5 章 CI (持续 集成 ) 


都 会 起 到 很 大 的 作用 。 
人 市 场 变化 的 速度 


如 今 的 市 场 瞬息 万 变 。 特 别 是 网 站 和 智能 手机 的 App，1 款 产 品 的 
开发 周期 一 般 不 足 1 至 2 年 。 因 为 在 开发 期 间 市 场 趋势 很 可 能 会 友 生 变 
化 ， 导 致 开发 出 来 的 产品 失去 作用 。 还 有 Web 之 外 的 一 些 类 似 于 财务 系 
统 这 样 的 业务 系统 ， 还 会 受到 突然 的 政策 修改 等 外 部 环境 变化 的 影 啊 。 

如 宁 每 次 都 按照 瀑布 式 的 开发 流程 ， 从 头 开 始 全 部 实施 的 话 ， 可 以 
说 很 难 跟 上 市 场 的 变化 。 话 虽 如 此 ， 如 果 只 是 单纯 地 提早 发 布 日 期 、 缩 
短 开发 日 程 ， 而 不 在 CI 等 方面 下 工夫 的 话 ， 那 只 会 造成 bug 和 退化 频 
发 ， 进 而 导致 发 布 的 产品 质量 下 降 。 效 果 恰 恰 相 反 。 

为 了 应 对 市 场 的 变化 ， 在 一 定 程度 上 不 得 不 牺牲 代码 的 可 读 性 和 可 
维护 性 。 特 别 是 在 产品 开发 初期 ， 这 是 第 有 的 事情 。 不 同 的 产品 可 能 
所 差异 ， 一 般 而 言 投入 市 场 越 迟 ， 就 越 容易 失去 机 会 。 最 差 的 情况 下 ， 
革 吉 开发 的 产品 可 能 完全 没有 被 用 户 接受 的 机 会 ， 产 品 开发 的 投入 完全 
打 了 水 漂 。 





























e…… 兼顾 开发 速度 和 质量 


如 何 才 能 既 保 持 能 够 应 对 市 场 变化 的 开发 速度 ， 又 保证 高 质量 呢 ? 
CI 就 能 起 到 重要 的 作用 。 

例如 ， 编 写 能 确保 产品 API 正 常 运行 的 最 低 限 度 的 测试 代码 并 执行 
CI， 在 保证 代码 内 容 正 常 运 行 的 基础 上 优先 同市 场 进 行 发 布 。 这 个 阶段 
代码 的 可 读 性 和 可 维护 性 较 差 ， 功 能 添加 也 不 方便 ， 只 是 姑且 能 够 运行 
并 加 用 户 提 供 价值 而 已 。 

确认 产品 能 够 正常 使 用 之 后 ， 再 用 考虑 了 之 前 牺牲 的 可 读 性 和 可 维 
护 性 的 代码 来 蔡 换 原 来 的 代码 。 这 是 为 了 应 对 下 一 个 阶段 ， 即 进一步 添 
加 功能 所 必需 的 。 

也 就 是 说 ， 初 期 优 移 速度 ， 致 力 于 尽快 上 市 ， 之 后 再 对 代码 进行 重 
构 以 提高 可 维护 性 。 而 文 持 上 述 方式 的 正 是 CI， 有 了 CI 上 述 方式 才 成 
为 可 能 。 既 应 对 了 市 场 的 快速 变化 ， 又 控制 了 确保 可 维护 性 和 开发 人 员 
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精神 健康 所 需 的 成 本 。 
综 上 ， 从 成 本 效益 和 市 场 的 变化 速度 这 两 个 角度 来 看 ，CI 这 样 的 实 
践 是 非常 重要 的 。 


5.1.4 Cl 的 必要 条 件 


seeeeeseeeeeeeseeseseeeeseseseeseesseeeseeseseeeeseeeeseeeseeeeeeseeseeeeseeseeeeseeseeseseeeeseeeseeseeeeeeeeseeee 








“CI 的 字面 意思 已 经 理解 了 ， 想 开始 着 手 实施 ， 应 该 怎么 做 呢 ? 从 
何 处 着 手 呢 ?” 为 了 回答 这 样 的 问题 ， 我 们 来 说 一 下 CI 的 必要 条 件 。 
开始 实施 CI 的 必要 条 件 如 下 。 


e@ 版 本 管理 系统 
@ build 工具 

@ 测试 代码 

e@ Cl 工具 


i 版 本 管理 系统 


实施 CI 过程 中 最 重要 的 部 分 就 是 版 本 管理 系统 。 正 如 第 3 章 中 所 
讲解 的 那样 ， 构 建 程序 所 必需 的 资源 应 该 尽 可 能 地 由 版 本 管理 系统 进行 
统一 的 管理 ， 这 是 非常 重要 的 。 例 如 代码 、 依 赖 关 系 、 数 据 库 模式 、 配 
置 文件 等 。 使 用 版 本 管理 系统 ， 任 何人 人、 任何 时 候 都 能 够 获取 最 新 的 资 
源 是 非 销 重要 的 。 














@.……. build 工具 
同样 重要 的 还 有 build 工具。 例如 make， 写 好 build 的 定义 后 ， 只 


要 执行 一 条 命令 ， 就 能 够 进行 代码 编译 、 数 据 库 构 建 和 测试 ， 并 最 终生 
成 可 以 运行 的 程序 。 主 要 的 build 工具 如 表 5.1 所 示 。 





表 5.1 主要 的 build 工具 





make 经 典 的 build 工具。 根据 Makefile 这 样 的 配置 文件 进行 build。UNIX 
下 的 软件 build 所 必 不 可 少 的 工具 ， 负 责 搭 建 服 务 器 的 工程 师 每 天 都 会 
接触 
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build 工具 


SCons 用 Python 编写 的 替代 make 的 工具 。 使 用 由 Python 写 的 配置 文件 
SConstruct 进行 build。 支 持 各 种 语言 的 build， 在 OSS 界 有 着 一 定 的 
占有 率 。 比 较 有 名 的 是 V8 ”的 build 就 使 用 了 该 工具 


Java 写 的 build 工具 ， 使 用 名 为 build.xml 的 XML 文件 来 定义 build 顺 
序 。 因 为 要 定义 build 顺序 ， 所 以 使 用 起 来 比 Maven 稍 显 复杂 ， 相 反 

也 正 因为 可 以 定义 build 顺序 ， 所 以 非常 灵活 ， 在 Java 的 世界 中 被 广 

泛 使 用 








由 Java 编写 的 项 目 管理 工具 。 用 pom.xml 文件 来 定义 build。Maven 
是 根据 CoC ( Convention over Configuration， 惯 例 优先 原则 ) 所 制作 
的 工具 ， 因 此 只 要 符合 Maven 的 规则 ， 就 很 少 需 要 对 build 进行 额外 


的 定义 。 反 之 ， 和 Ant 相 比 灵活 性 要 差 了 些 。 另 外 ，Maven 作为 项 目 
管理 工具 ， 除 了 build 以 外 还 具有 项 目 网 站 的 生成 、 测 试 的 执行 以 及 部 
器 等 各 类 功能 

Gradle 是 近年 来 Java 界 比 较 受 关注 的 新 build 工具 。 它 并 非 使 用 
Java， 而 是 用 名 为 Groovy 的 JVM ( Java Virtual Machine ) 上 运行 的 
脚本 语言 编写 的 。 配 置 也 可 以 使 用 Groovy 编写 ， 比 XML 可 读 性 强 、 
自由 度 高 。 还 可 以 只 使 用 Gradle 进行 依赖 关系 的 管理 <。 如 果 觉 得 Ant 
过 于 复杂 ，Maven 又 缺乏 灵活 性 ， 可 以 考虑 使 用 Gradle 作为 解决 这 两 
个 问题 的 build 工具 

Ruby 编写 的 build 工具 。 使 用 由 Ruby 编写 的 配置 文件 Rakefile。 随 着 
Ruby on Rails 的 普及 ， 以 及 以 Chef 和 Capistrano 为 代表 的 服务 器 构 
建 自动 化 工具 ”的 普及 ，Rake 开始 被 广泛 使 用 

















当然 ， 如 果 无 论 如 何 现 有 的 工具 都 不 可 用 的 话 ， 也 可 以 用 shell 脚 
本 或 其 他 熟悉 的 语言 自行 编写 build 脚本 ,但 这 里 并 不 推荐 这 样 做 。 多 
数 情况 下 使 用 表 5.1 中 的 build 工具 都 应 该 能 够 满足 需求 。 并 且 如 果 使 用 
的 是 全 栈 式 〈full stack ) Web 应 用 程序 框 染 的 话 ， 有 的 框架 也 会 自 带 
build 工具 。 

无 论 使 用 哪 一 款 工具 ， 重 要 的 都 是 要 具备 无 论 谁 在 什么 时 候 进 行 了 
提交 ，build 所 需 的 处 理 都 能 自动 进行 这 样 的 机 制 。 











Google 的 JavaScript 引擎。 
实际 上 其 内 部 包含 了 Ivy， 由 Jvy 进行 依赖 关系 的 管理 。 
Chef 和 Capistrano 都 是 由 Ruby 编写 的 工具 ， 和 同样 可 以 用 Ruby 来 定义 build 的 
Rake 配合 度 较 好 。 因 此 多 数 的 Chef 和 Capistrano 的 任务 都 是 由 Rake 来 编写 的 。 


OOO 
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@…… 测试 代码 


CI 中 的 build 工作 并 不 是 仅仅 将 代码 编译 一 下 就 结束 了 。 执 行 测试 ， 
持续 地 确认 应 用 程序 的 正确 性 也 是 非常 重要 的 。 通 过 测试 来 确保 程序 的 
正确 性 就 不 必 担 心 退 化 的 发 生 ， 能 够 大 胆 地 添加 新 功能 和 进行 代码 重 
构 ， 还 能 够 加 快 开 发 速度 、 提 高 产品 质量 。 用 于 编写 测试 代码 的 框架 的 
相关 内 容 将 稍 后 讲解 。 

















当然 ， 执 行 CI 需要 相应 的 工具 。CI 工具 是 将 版 本 管理 系统 和 代码 、 
build 工具 组 合 起 来 ， 持 续 地 进行 集成 作业 的 工具 。 如 果 仅 仅 是 执行 目 动 
build、 自 动 测试 的 话 ， 不 使 用 CI 工具 也 可 以 进行 。 但 通过 利用 CI 工具 
的 各 类 功能 ， 能 够 解决 很 多 问题 ， 比 如 自动 化 测试 何 时 进行 ， 执 行 的 结 
采 如 何 显示 和 通知 ，build 结果 和 版 本 管理 系统 、 缺 陷 管 理 系统 之 间 的 可 
追溯 性 如 何 确 保 等 。 











5.1.5 ”编写 测试 代码 所 需 的 框架 


编写 测试 代码 所 需 的 框 江 有 以 下 两 种 。 


e@ 测试 驱动 开发 ( TDD ) 的 框架 
e@ 行为 驱动 开发 ( BDD ) 的 框架 


e…… 测试 驱动 开发 ( TDD ) 的 框架 


即 实现 测试 驱动 开发 ( Test Driven Development，TDD ) 所 和 需 的 框架 。 

在 编写 应 用 程序 的 代码 之 前 ， 为 了 确认 需求 先 编写 测试 代码 ( test 
first )， 然 后 再 编写 符合 测试 代码 的 应 用 程序 代码 ， 这 样 的 手法 就 是 
TDD。 这 也 是 极限 编程 ( XP ) 实践 的 一 种 。 具 有 代表 性 的 测试 驱动 开 
发 框架 有 Java 的 JUnit 和 TestNG “等 ,还 有 为 数 众多 的 各 类 语言 的 xUnit 














DD http://junit.org/ 
© http://testng.org/ 
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系列 框 染 。 
例如 JUnit 的 情况 下 ， 对 于 Sample 类 的 getName () 为 数 ， 可 以 
像 下 面 这 样 编写 测试 代码 。 
public class SampleTest { 
Cesie 
public final voidq testSamplegetNameIsTakafumi () { 
Sample sample = new Sample() ; 
assertThat (sample.getName(), is("Takafumi")); 


} 
} 


这 些 xUnit 系列 框架 的 特征 是 : 通过 编写 测试 用 例 ， 硝 认 测 试 对 
象 类 以 及 方法 的 动作 的 正确 性 。 换 言 之 ， 也 可 以 理解 为 根据 测试 代码 
来 设计 类 的 API。 这 个 特征 和 接 下 来 的 行为 驱动 开发 工具 形成 了 很 好 的 
对 照 。 








@…… 行为 驱动 开发 ( BDD ) 的 框架 

从 测试 驱动 开发 发 展 而 来 ， 近 年 来 逐渐 流行 起 来 的 便 是 行为 驱动 开 
发 ( Behavior Driven Development，BDD )。BDD 和 TDD 一 样 都 是 最 先 
编写 测试 代码 。 

和 TDD 的 不 同 之 处 在 于 ，TDD 是 针对 程序 的 API 编写 测试 ， 而 
BDD 则 是 接近 于 需求 次 明 的 编写 方法 。 如 同 其 名 字 一 样 ，BDD 看 眼 于 
程序 的 行为 。 其 方式 是 在 需求 确定 后 编写 应 用 的 代码 ， 所 以 与 TDD 的 
测试 优先 相对 ，BDD 可 以 说 是 需求 优先 ( spec first )。 

BDD 的 代表 性 框架 有 Ruby 的 RSpec" 和 Cucumber  、J avaScript 的 
Jasmine”\Scala 的 Specs2 等 。 其 他 还 有 各 个 语言 所 对 应 的 xSpec 系列 的 
框架 。 男 外 ，Cucumber 方面 ， 对 Ruby 之 外 的 各 语言 的 支持 也 在 正式 发 
布 中 。 

例如 Cucumber 面 问 Java 实现 的 Cucumber-jvm 中 ， 在 名 为 sample. 

















http://rspec.info/ 
http://cukes.info/ 
http://Jasmine.github.10/ 


©OOOO 


http://specs2.0rg/ 
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feature 的 文件 中 用 目 然 语言 如 下 这 样 描述 需求 。 


#language: ja 

特征 ( feature ) : Sample 功 能 
场景 ( scenario ) : 确认 Sample 类 中 的 Name 属 性 
前 提 : new Sample 类 
结果 : getName 的 返回 值 应 该 为 “Takafumi” 


接着 如 下 定义 空 的 测试 类 。 


oe Oe lie , Oe o RA aL els 


import cucumber.junit.Cucumber,; 


@RuNnWith (Cucumber.class) 
@Cucumber .Options (format={"pretty"}) 
public class SampleTest { 


} 
定义 好 之 后 ， 像 通常 的 JUnit 一 样 执行 上 述 文 件 ， 标 准 输出 会 显示 
如 下 代码 。 


You can implement missing steps with the snippets below: 


@ 前 提 ("^: new Sample 类 $") 

public void new Sample 类 () throws Throwable f{ 
// Express the Regexp above with the code you wish you had 
throw new PendingException(); 


} 


@ 结 果 ("^: getName 的 返回 值 应 该 为 \”([^\ ]*)\”$") 

public void getName 应 该 为 (String arg name) throws Throwable { 
// Express the Regexp above with the code you wish you had 
throw new PendingException(); 


gh 


这 就 是 用 自然 语言 描述 的 sample.feature 所 对 应 的 测试 代码 的 秩 形 。 
将 这 段 雏 形 代码 复制 粘贴 到 刚才 空 的 测试 类 中 并 加 以 实现 。 本 例 的 具体 
实现 如 下 。 

之 后 只 需要 问 sample.feature 用 目 然 语言 添加 需求 并 执行 测试 即 可 。 
问 sample.feature 中 添加 的 需求 如 果 没 有 在 测试 类 中 进行 实现 的 话 ， 就 
会 在 标准 输出 中 显示 代码 ， 提 示 要 添加 新 的 测试 函数 。 

像 这 样 根据 上 自然 语言 描述 的 需求 (行为 的 定义 ) 来 编写 测试 代码 ， 
这 就 是 Cucumber 的 方式 。 
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这 些 处 理 在 技术 上 和 JUnit 并 没有 太 大 的 变化 ， 区 别 仅 在 于 测试 的 
编写 方式 和 执行 方式 。 虽 说 如 此 ， 也 正 是 因为 这 些 不 同 之 处 ，Cucumber 
才 使 验收 人员 能 够 用 自然 语言 编写 需求 规格 。 

这 次 用 Cucumber 试 着 写 了 Sample 类 的 单元 测试 。 本 来 Cucumber 
是 用 来 定义 行为 并 进行 测试 的 工具 ， 所 以 一 般 多 用 于 结合 多 个 类 的 测 
试 。 也 就 是 说 ，Cucumber 原本 是 用 于 确保 集成 测试 和 用 户 验 收 测试 的 。 
这 次 是 为 了 对 比 TDD 框架 和 BDD 框架 而 特意 编写 了 相同 的 测试 。 

大 多 数 的 需求 都 能 用 接近 上 自然 语言 的 DSL (Domain Specific 
Language ) "来 编写 ， 这 是 BDD 的 特点 。 使 用 近似 于 自然 语言 的 DSL 来 摘 
述 需 求 ， 然 后 直接 将 其 用 于 测试 。BDD 是 以 让 负责 需求 定义 的 人 或 客 
户 等 立场 上 接近 于 产品 利益 相关 者 的 人 也 能 够 编写 需求 为 目的 而 设计 
的 ， 这 也 是 其 特征 。 与 之 相对 ，TDD 框架 的 机 制 是 促进 API 的 设计 。 

















5.1.6 主要 的 CI 工具 





seeeeeeseeeeeseseeseeeeeeseeeseeeeeeseeseeeseseeseeeeeeseeseseeeeeseseeseeeseseeseeeeeeseeseeeeeeeseee 


CI 工具 数量 众多 ， 具 有 代表 性 的 有 以 下 两 个 。 


@ Jenkins® 


@ TravisCI2 


es Jenkins 


原名 为 Hudson 的 Jenkins 如 今 可 以 毫 不 为 过 地 说 是 CI 工具 事实 上 
的 标准 。 全 世界 的 项 目 都 在 使 用 Jenkins ( 图 5.4 )。 
(DD 和 Java、Ruby 这 样 通用 的 程序 不 同 ，DSL 是 为 了 解决 特定 领域 的 问题 而 设计 的 


语言 ， 因 此 也 称 为 领域 特定 语言 。 
http://Jenkins-ci.org/ 





https://travis-ci.org/ 

原本 是 Sun Microsystems 旗下 的 作为 OSS 开发 的 名 为 Hudson 的 工具 。 由 于 
Oracle 收购 Sun Microsystems 而 产生 的 商标 问题 ， 开 源 社区 在 2010 年 对 Hudson 进 
行 了 fork (复制 代码 并 作为 另外 的 项 目 重新 开始 )， 并 将 其 改名 为 Jenkins。 之 后 
几乎 所 有 Hudson 的 提交 者 都 转移 到 了 Jenkins 项 目 ，Oracle 也 因为 无 法 继续 维护 
Hudson 项 目 ， 最 终于 2012 年 未 将 其 转交 给 了 Eclipse 基金 会 。 后 来 就 几乎 没有 向 
Hudson 项 目的 代码 提交 了 ， 而 Jenkins 则 作为 名 副 其 实 的 活跃 着 的 项 目 留 了 下 来 。 


外 的 的 
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图 5.4 Jenkins 


€ Jenkins 


| 
An extendable open source continuous integration Server 








Ds) 
i 


BLOG CONNECT BUG TRACKER WIKI Ci TUTORIALS ARCHIVES DONATION ABOUT 


Download Jenkins 
Release Long-Term Support Release 





Meet Jenkins 


Find out what Jenkins is and get started. Java Web Archive (.war) 
Latest and greatest (1.515) 
changelog | past releases | RC 
upgrading from Hudson? 
Or native package 
Use Jenkins 3 
See how to get more out of your Jenkins. Windows 





Ubuntu/Debian 
Red HatFedora/CentOS 


Mac OS X 
人 Customize Jenkins = 
人 Choose from over 600 plugins to customize Jenkins exactly to your needs. @ openSUSE 


在 Jenkins 之 前 还 有 过 Continuum 和 Cruise Control 等 ， 几 乎 都 已 经 
没有 存在 感 了 。 从 Jenkins 被 称 为 事实 上 的 标准 可 以 看 出 ，Jenkins 具备 
丰富 的 功能 并 且 安 装 简便 。Jenkins 的 相关 内 容 将 在 5.4 节 进 行 讲 解 。 














©…… TravisCw| 


作为 通用 的 CI 工具 ，Jenkins 可 以 说 是 一 个 非常 不 错 的 选择 ， 但 最 
近 使 用 TravisCI 的 情况 也 开始 逐渐 增加 (图 5.5 )。TravisCI 是 GitHub 提 
供 的 配套 的 CI 工具。 虽然 非 GitHub 的 项 目 无 法 使 用 ， 但 它 设 置 简 单 ， 
只 需要 5 分 钟 左右 就 能 够 开始 CI。 





5.5 TravisCl 
QT ravis 














上 
Rails/Rails rails/rails © Sponsors 
Ruby on Rails 
me=cid 和 和 
My Repositories Recent lomi that ma 
© heartrails/rails4-example 39 Current Bulld History Pull Requests Branch Summary 兴 一 
© 13 min 55 sec, 9 days ago @ MOoNOGO HQ 
Build Message Commit Duration 
H H See aill of Our amazing sponsors 一 
© rails/rails 7571 © 7571 Add note about decorator loading in Engines guide. ab28baf (masten 2 hrs 43 min 46 sec 
© 2 hrs 43 min 46 sec, a day ago 
@ 7570 Restorerescue block forwhen IMis enabled 8799cfa (3-2-stable) 6 hrs 54 min 10 sec 
Sponsors 
© rails/rails-observers 9 @7569 Mergepullrequest#10745 from 7101a85 (3-2-stable) 5 hrs 37 min 27 sec 
i Cloudant: grow into your data 
© 1 min 32 sec, about a month ago SO TU 9 2 
layer, not out of it 
©7568 Mergepull request #10713 from d293990 (3-2-stable) 3 hrs 48 min 28 sec 
; senny/10693_flx_primary_key_option_on_has_man Zendesk: Love your helpdesk 
© prograils/railspeople 30 y 2 ny 
© 4 min 42 sec, about a month ago ©@7567 Mergepullrequest#10713 from d87ee0a (4-0-stable) 2 hrs 44 min 36 sec Mindmatters: Software fir 
senny/10693_fix_primary_key_option_on_has_many Menschen 
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TravisCI 的 功能 虽然 并 不 多 ， 但 就 进行 单元 测试 和 集成 测试 来 说 已 
经 足够 了 。 并 且 还 能 够 和 GitHub 密切 关联 ， 使 GitHub 项 目 最 近 的 build 
状态 一 目 了 然 (图 5.6 )。 


图 5.6 用 图 标 表示 build 状态 
Code Status 

















在 合并 Pull Request 之 前 能 够 自动 执行 测试 ， 这 是 TravisCI 的 特 
长 ”。 借助 上 述 功 能 ,就 能 够 避免 在 合并 Pull Request 之 后 才 发 现 build 出 
错 的 事态 ， 使 得 高 效 的 团队 开发 成 为 可 能 。 

以 前 TravisCI 只 能 用 于 公开 的 代码 库 ， 从 2013 年 开始 私有 的 代码 
库 也 能 使 用 了 。 因 此 如 果 在 使 用 GitHub 的 话 ，TravisCI 可 以 说 是 值得 考 
虑 的 工具 。 





(D 顺便 提 一 下 ，Jenkins 通过 使 用 插件 也 能 够 够 实现 同样 的 功能 。 这 部 分 内 容 将 在 54 
节 进 行 讲 解 。TravisCI 默认 支持 Pull Request 的 CI， 这 点 非常 方便 。 
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5.2 build 工具 的 使 用 方法 


本 节 将 对 实现 CI 所 需 的 build 工具 的 使 用 方法 进行 简单 的 讲解 。 

虽说 build 上 自动 化 是 实现 CI 所 必 不 可 少 的 ， 但 是 没有 实现 build 自 
动 化 的 开发 现场 并 不 在 少数 。 像 Java 这 样 比 较 多 地 使 用 IDE ( Integrated 
Development Environment， 集 成 开发 环境 ) 进行 开发 的 现场 ， 特 别 

IDE 将 编译 (compile )、build、 程 序 的 启动 ， 到 测试 的 执行 等 所 有 
流程 进行 了 半 上 自动 化 封装 ， 用 起 来 的 确 非 常 方便。 但 几乎 所 有 的 操作 都 
要 通过 GUI 来 设置 ， 在 实施 build 目 动 化 时 反而 会 成 为 阻碍 。 与 之 相对 ， 
使 用 脚本 语言 的 开发 现场 由 于 缺乏 IDE 的 支持 ， 比 较 多 见 的 是 从 一 开始 
就 使 用 build 工具 来 实施 自动 化 。 

还 有 一 些 开 发 现场 是 开发 人 员 用 IDE 进行 build， 负责 build 的 人 员 
用 Ant 这 样 的 工具 重新 build 后 再 实施 QA 和 部 署 。 这 样 的 做 法 会 造成 
开发 时 和 QA 时 的 build 方法 产生 差异 ， 所 以 应 该 避免 这 样 的 做 法 。 

确保 开发 人 员 、 测 试 人 员 、 负 责 build 的 人 员 、 负 责 发 布 的 人 员 都 
能 使 用 相同 的 方法 进行 build， 这 对 于 CI 的 实现 是 非常 重要 的 。 因 此 开 
发 人 员 也 应 该 从 一 开始 就 使 用 build 工具 来 构建 开发 环境 。 

build 工具 种 类 繁多 ， 请 根据 使 用 的 语言 以 及 开发 环境 来 选择 合适 的 
build 工具 。 





























5.2.1 新 建 工程 的 情况 


这 里 以 Java 为 例 进 行 讲 解 。 

开始 新 的 工程 ， 使 用 Maven 等 工具 从 夫 建 立 工程 的 雏形 。 

Maven 是 根据 CoC ( Convention over Configration， 惯 例 优先 原则 ) 
的 思想 而 设计 的 build 工具。 其 目录 的 构成 等 都 有 明确 的 规定 ， 能 够 高 








图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


158 | 第 5 章 CI (持续 集成 ) 


效 地 进行 build。Maven 的 安装 方法 请 参考 相关 网 站 “或 书籍 “。 撰写 本 书 
时 (2014 年 3 月 ) Maven 的 最 新 版 本 是 3”。 

Maven 工程 锥 形 的 建立 方式 有 两 种 : 从 命令 行 建立 和 通过 IDE 的 
GUI 建立 。 

Maven 还 是 一 款 能 够 和 Eclipse 以 及 IntelliJ IDEA "等 IDE 紧密 Ga 
的 工具 ， 能 够 通过 IDE 的 GUI 进 但 Maven 原本 是 作为 命令 
工具 设计 的 ， 因 此 应 该 尽 可 能 地 通过 命令 行 来 调用 ， ub 
烦 。 

这 里 将 简单 介绍 从 命令 行 建 立 工 程 和 雏形 到 导入 Eclipse 的 过 程 。 








和 建立 工程 雏形 


Maven 安装 完成 后 ， 执 行 以 下 命令 来 建立 工程 稚 形 “。 


$ mvn archetype:generate 


稍 许 等 竺 后 会 出 现 如 下 使 用 何 种 工程 骏 形 的 询问 。 本 书 执 笔 时 共有 
914 种 雏形 可 供 选 择 。 这 里 使 用 Maven 建议 的 最 基本 的 344 号 工程 雏 
形 。 确 定 后 按 下 回 车 键 。 


略 











913: remote — tk.skuro:clojure-maven-archetype (A simple Maven archetype 
eeenusey 

914: remote — uk.ac.rdg.resc:edal-ncwms-based-webapp (-) 

Choose a number or apply filter (format: [groupld:]artifactId, case 
sensitive contains): 344: 


接着 会 询问 秩 形 的 版 本 、groupId、artifactId 等 必要 的 信息 。 


Choose org.apache.maven.archetypes:maven-archetype-quickstart version: 
了 8 4L,0= 旺 Ga= 山 








(D http://maven.apache.org/ 

@) Apache Maven 3 Cookbook, Srirangan 著 ，Packt Publishing，2011 

(3) 国内 的 相关 书籍 以 及 网 站 上 的 内 容 几 乎 都 是 关于 Maven3 的 ， 这 点 请 注意 。Maven3 
最 大 限度 地 考虑 了 和 Maven?2 之 间 的 兼容 性 ， 因 此 在 Maven2 上 能 够 运行 的 在 
Maven3 上 基本 都 能 运行 ， 但 也 有 例外 。 还 需要 注意 Maven1，Mavenl 和 Maven2、 
Maven3 并 不 兼容 。 参 考 网 络 上 的 资料 时 ， 请 一 定 要 注意 译 者 注 

由 http:/www.jetbrains.com/idea/ 

(5) Maven 会 首先 从 互联 网 上 下 载 必 要 的 模块 ， 并 build 执行 命令 的 环境 。 因 此 第 一 


次 启动 Maven 时 会 执行 下 载 和 build， 需 要 等 待 一 段 时 间 。 
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23 1.Q=&l1LDNna=2 

BE ua 

4: 1.0-alpha-4 

Sh: 0 

Ge 

Choeose'anmvmer ee: 

Define Value for property 'groupld': : com.gmail.ikeike443 
Define Value for property 'artifactId': : sample 

Define Value for property 'version': 1.0-SNAPSHOT: : 

Define Value for property 'package': com.gmail.ikeike443: : 


首先 要 选择 maven-archetype-quickstart 的 版 本 ,使 用 最 新 
的 版 本 ( 这 里 是 6:1.1 )， 然 后 按 下 回 车 。 

groupId 会 指定 区 分 团队 或 项 目 等 多 个 产品 的 Id。 通 稼 将 所 属 团队 
的 域名 等 用 点 分 割 并 倒序 显示 。 这 里 使 用 笔者 自己 的 邮件 地 址 。 

artifactId 为 项 目 自 身 的 名 字 ， 请 根据 项 目 设 置 合适 的 名 字 。version 
这 次 直接 使 用 默认 值 即 可 。 按 下 回 车 。package 通常 可 以 和 groupId 相 
同 ， 因 此 使 用 默认 值 ， 按 下 回 车 确认 即 可 。 

最 后 是 配置 内 容 的 确认 ， 没 有 问题 的 话 请 按 下 局 键 。 


Confirm properties configuration: 












































grouplId: com.gmail.ikeike443 
artifactId: sample 

version: 1.0-SNAPSHOT 

package: com.gmail.ikeike443 
VY 


奇 输出 BUILD SUCCESS， 就 算 成 功 了 了 。Maven 会 生成 名 为 sample 
的 目录 ， 进 入 该 目录 。 
$ cd sample 

可 以 确认 samp1le 目 录 下 生成 了 如 下 目录 结构 。 


S tree 





gmail 
[一 1ikeike443 
-一 一 Appb.java 
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gmail 
-一 1ikeike443 
-一 一 AppTest .java 


11 directories，3 files 
src/main/java 是 程序 代码 的 目录 。src/test/java 是 测试 代码 的 目录 。 
像 这 样 ，Maven 能 够 将 程序 代码 和 测试 代码 存放 在 同一 工程 的 不 同 目录 
F 。 请 注意 这 里 的 “同一 工程 ”是 重点 。 

为 了 有 效 地 执行 CI， 将 应 用 程序 代码 和 测试 代码 一 同 置 于 版 本 管理 
系统 中 是 非常 重要 的 。Maven 就 是 一 球 能 够 简单 地 实现 上 述 需求 的 工 
具 。 其 他 的 语言 也 有 类 似 的 工具 ， 可 以 自行 选择 合适 的 工具 。 

Maven 的 构成 如 表 5.2 所 示 “。 


表 5.2 Maven 的 构成 


目录 /文件 说 明 
pom.xml 工程 的 build 定义 
src/main/java 程序 代码 





























src/main/resources 程序 资源 


src/main/webapp WEB-INF、JSP 文件 等 Web 相关 的 资源 
src/test/java 测试 代码 

src/test/resources 仅 供 测试 使 用 的 资源 

Class、jar、 测 试 结果 等 文件 








@…… 依赖 关系 的 定义 


第 3 草 中 已 经 提 到 过 ， 通 过 在 pom.xml 中 使 用 <dependencies> 
标签 定义 依赖 关系 ，Maven 会 处 理 所 依赖 库 的 传递 依赖 ， 将 所 需要 的 库 





添加 到 classpath 中 。 
例如 本 次 的 工程 稚 形 中 ， 像 下 面 这 样 定义 junit 的 依赖 关系 。 
<dependencies> 


Q) Maven 还 可 以 用 于 Java 以 外 的 JVM 语言 的 build。 这 时 Maven 一 般 会 在 Java 目 
录 的 同一 层次 中 建立 以 groovy、scala、jruby 等 语言 命名 的 目录 。 
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<dependency> 
和 GUODTGE Uit</drouLd> 
eh ya ee 
cenSnion oe ye 
<scope>test</scope> 
</dependency> 
</dependencies> 


这 里 定义 了 JUnit3.8.1， 由 于 3.8.1 太 旧 了 ， 请 手动 改写 为 4.1.1 等 
当时 的 最 新 版 本 。 
那么 就 让 我 们 来 试 着 编译 一 下 。 执 行 如 下 命令 。 


$ mvn compile 


编译 后 Maven 会 在 target 目录 下 生成 Class 文件 。 
e…… 执行 测试 


这 次 我 们 来 试 着 执行 测试 。 虽 然 AppTest.java 依赖 了 junit， 但 因为 
已 经 在 pom.xml 中 定义 了 依赖 关系 ， 所 以 可 以 直接 执行 测试 。 


S mvn test 

[LINSO)] SEanmine Or EOIEQES.。. 
[INFO] 
[INFO] 


[INEO] 


RUunning com.gmail.ikeike443.AppTest 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.049 sec 


Results : 


ess un soe 


[INFO] ------- 
[NEOHEEUTD SUCCESS 

[INEO 
[INEO] Total time: 13.2828s 


[LINSO) BlinAliSnee ats Ti Mey 23 18:06:32 JSI 2013 
[INFO] Final Memory: 15M/145M 
[INEO] 
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Maven 会 自动 处 理 对 JUnit 的 依赖 ， 编 译 代码 并 执行 测试 。 

测试 结果 会 在 target/surefire-reports/ 目 录 下 生成 ,以 文 
本 文件 和 XML 文件 两 种 形式 存储 。 这 个 XML 文件 在 Jenkins 生成 报告 
时 会 起 到 作用 。 

使 用 Maven 插件 ， 测 试 结果 报告 还 可 以 自 定 义 为 HTML 等 各 类 形 
式 ， 这 方面 的 内 容 请 参考 相关 资料 。 


和 导入 Eclipse 


最 后 让 我 们 试 着 导入 Eclipse。 运 行 以 下 命令 即 可 生成 Eclipse 专用 
的 .classpath 和 .project 文件 。 


$ mvn eclipse:eclipse 


只 要 从 Eclipse 的 菜单 导入 生成 的 .project 文件 ， 就 可 以 用 Eclipse 
打开 Maven 工程 了 。IntelliJ IDEA 和 Netbeans 也 有 支持 同样 功能 的 插 
件 ， 可 以 根据 需要 使 用 。 

相反 ， 通 过 IDE 的 GUI 也 可 以 初始 化 Maven 的 工程 。Eclipse 从 
3.7 版 ( Indigo ) 开始 默认 支持 Maven”。 基 本 上 通过 新 建 工程 向 导 就 能 
建立 Maven 工程 。 根 据 回 导 的 提示 ， 一 步 一 步 地 执行 即 可 。 上 再 重复 一 
下 ， 充 分 使 用 命令 行 对 于 有 效 地 执行 CI 是 非常 重要 的 ， 因 此 尽 可 能 地 
通过 命令 行 来 使 用 Maven。 














5.2.2 为 已 有 工程 添加 自动 build 功能 


新 建 工 程 时 ， 使 用 Maven 这 样 的 CoC 的 build 工具 来 初始 化 工程 是 
最 简单 的 ， 但 同样 存在 已 有 的 没有 使 用 build 工具 的 工程 。 这 样 的 情况 
下 ， 如 果 是 Java 工程 ， 可 以 使 用 Ant 进行 build。 

Ant 不 像 Maven 这 样 有 着 固定 的 规则 。 另 外 ， 因 为 Ant 运行 在 JVM 
之 上 ， 所 以 有 着 不 同 于 Make 依赖 于 执行 环境 的 特点 。 从 目录 的 构成 到 
依赖 关系 的 处 理 、 测 试 的 执行 都 可 以 自由 地 进行 定义 。 因 此 根据 已 有 的 





(D https://netbeans.org/ 
@) 3.6 版 之 前 的 版 本 需要 另行 安装 名 为 m2eclipse 的 插件 。 
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工程 编写 build.xml 即 可 。 

Ant 默认 定义 有 compile、test、package 这 样 的 任务 ， 可 以 利 
用 这 些 任 务 快速 地 进行 build。 

但 是 Ant 没有 默认 进行 依赖 关系 管理 ， 因 此 推荐 使 用 Ivy 这 款 工 
具 。Ivy 是 将 Maven 的 依赖 关系 管理 功能 独立 出 来 的 工具 ， 可 以 结合 
Ant 使 用 。 


5.2.3 build 工具 的 总 结 





seeeeeeeseeeeeeeseseeseeeseseeeseeeeseeseseeseeeeeeseeseeseeseeseeeeeeseeseseeeeeseseeseeeeeeeeseeee 


为 了 实施 CI， 首 先 实 现 build 的 日 动 化 是 非常 重要 的 ， 可 以 说 是 必 
不 可 少 的 。 这 里 以 Java 工程 为 例 ， 简 单 地 介绍 了 build 工具 的 使 用 方法 。 

新 建 工 程 请 使 用 Maven， 已 有 工程 请 使 用 Ant， 来 开始 实施 build 目 
动 化。 也 可 以 使 用 Gradle。 不管 选择 哪 蒜 工具 ， 实 现 build 的 自动 化 是 
非常 重要 的 。 

利用 Java 开发 Web 应 用 程序 的 情况 下 ， 通 过 结合 Maven 或 Ant 对 
jetty、Struts2、Spring、Hibernate 这 样 的 servlet 容 表 或 各 类 框架 进行 
build， 可 以 实现 build 的 自动 化 。 

另外 也 可 以 使 用 全 栈 式 的 Play Framework 作为 Java 的 Web 应 用 程 
序 框架 。Play Framework 虽然 不 使 用 Maven 和 Ant， 但 默认 支持 日 动 化 
编译 以 及 自动 化 测试 的 机 制 ， 因 此 是 非常 适合 于 CI 的 框架 

















(QD) http://ant.apache.org/ivy/ 
© http:/www.playframework.com/ 
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5.3 测试 代码 的 与 法 


目 动 化 测试 可 以 说 是 CI 的 重点 。 如 同 我 们 在 第 2 章 问题 5 中 所 见 ， 
如 果 不 和 后续 地 执行 日 动 化 测试 ， 就 无 法 发 现 不 知 不 党 中 发 生 的 退化 。 

同样 还 有 问题 7， 因 为 缺乏 测试 ， 所 以 无 法 进行 重 构 。 通 过 实施 
CI， 构 筑 起 能 够 时 党 目 动 执行 测试 的 环境 ， 那 样 就 应 该 有 信心 进行 重 构 
了 了。 从 长 期 来 看 也 能 够 有 效 地 提高 开发 质量 。 随 着 质量 的 提高 ， 添 加 新 
功能 的 速度 也 会 相应 地 加 快 ， 并 最 终 向 客户 提供 更 多 的 价值 。 

时 说 CI 的 目 动 化 测试 能 有 效 提高 开发 速度 及 质量 ,但 为 了 执行 
动 化 测试 ， 必 须 编 写 测试 代码。 

请 使 用 之 前 叙述 过 的 TDD 或 BDD 等 测试 框架 来 编写 测试 代码 。 还 
有 一 些 Web 应 用 程序 框架 原生 目 带 测试 框 漆 。 

















5.3.1 作为 CI 的 对 象 的 测试 的 种 类 


一 般 来 说 软件 测试 可 进行 如 下 分 类 “。 


eeeeseeeseeeeeeseeeeeesesseeeseeseeeeseeseeseeeeseeeseeeseseeeeseee 





e@ 单元 测试 ( Unit Test，UT ) 

e@ 集成 测试 ( Integration Test，IT ) 

e@ 用 户 验 收 测试 ( User Acceptance Test，UAT ) 
e@ 回归 测试 


其 中 哪些 应 该 作为 CI 的 对 象 呢 ? 答案 是 全 部 。 当 然 测 试 的 搭建 是 
一 项 耗费 成 本 的 工作 ， 因 此 要 根据 项 目的 状况 ,仔细 考虑 希望 得 到 的 测 
斌 效果 和 成 本 之 间 的 平衡 。 但 是 如 果 成 本 允许 的 话 ， 还 是 应 该 将 上 述 所 
有 测试 都 作为 CI 的 对 和 象 。 





QD 除 此 之 外 还 有 性 能 测试 、B 用 户 测试 等 各 类 测试 ， 这 里 就 不 提 了 。 
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本 音 对 主要 由 开发 人 员 编 写 的 单元 测试 和 集成 测试 的 CI 实施 进行 
说 明 。 用 户 验 收 测试 的 相关 内 容 将 在 第 7 章 进行 讲解 。 而 利用 CI 持续 
地 执行 测试 可 以 说 就 是 回归 测试。 


5.3.2” 何 时 编写 测试 


seeeeeseeeseeeeeeseeeseeseeseseeseeseeeseseeeeeeseseeseeeeseeeseeseeeeseeseeeeseeseesseeeeseseeseeeseeeeeeeeseeee 














何 时 编写 测试 代码 ? 根据 时 间 以 及 项 目 状况 的 不 同 ， 需 要 注意 的 事 
项 也 有 所 不 同 。 


@.……… 新 建 工 程 的 情况 


在 5.2 节 中 己 经 讲解 过 ， 新 建 工程 时 ， 请 将 测试 框架 和 Maven 等 
build 工具 一 起 导入 。 也 可 以 使 用 Ruby on Rails 或 Play Framework 等 全 
栈 式 Web 应 用 程序 框 染 。 每 次 新 建 类 或 添加 方法 时 ， 都 要 注意 将 测试 代 
码 一 同 讨 加 ， 并 一 同 提 交 到 版 本 管理 系统 。 

编写 测试 代码 ， 从 短期 看 来 ， 很 多 人 担心 会 影响 开发 速度 。 这 样 的 
想法 是 不 正确 的 。 在 工程 代码 的 基础 上 还 要 编写 测试 代码 ， 这 的 确 会 耗 
费时 间 ， 因 此 仅 从 完成 编码 的 时 间 来 看 的 确 是 延长 了 。 但 是 编写 测试 代 
人 色 是 开发 人 员 必 须 进 行 的 重要 工作 ， 因 为 开发 人 员 的 工作 并 不 是 只 要 完 
成 编码 就 结束 了 ， 而 是 要 回顾 客 提供 价值 。 换 言 之 ， 就 是 要 编写 按照 预 
期 运行 的 软件 ， 提 供 没 有 退化 的 产品 。 

使 用 测试 优先 或 者 需求 优先 的 开发 方式 ， 就 能 够 在 编写 代码 的 同时 
确认 程序 是 否 正常 运行 ， 进 而 使 返工 减少 ， 开 发 的 整体 速度 加 快 。 


























e… 已 有 工程 中 没有 测试 的 情况 


很 多 已 有 的 工程 都 没有 实施 自动 化 测试 。 根 据 工 程 规模 的 不 同 ， 应 
该 采取 的 措施 也 有 所 差异 ， 但 还 是 应 该 尽 可 能 地 为 能 够 测试 的 部 分 编写 
测试 代码 。 

但 未 经 测试 的 代码 往往 是 无 法 编写 或 者 很 难 编写 测试 的 代码 。 类 没 
有 得 到 合理 地 职责 分 割 ， 与 RDBMS 或 外 部 系统 的 API 紧密 耦合 ， 不 启 
动 整个 程序 就 无 法 确认 动作 ， 这 些 都 是 常 有 的 事情 。 在 这 样 的 情况 下 ， 
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首先 请 编写 从 最 外 侧 确保 程序 动作 的 测试 代码 。 这 里 的 “最 外 侧 ”是 指 
用 户 所 看 到 的 用 户 界面 。 

Web 应 用 程序 方面 ， 有 一 款 名 为 Selenium 的 模拟 浏览 器 动作 并 进行 
测试 的 著名 工具 。 首 先 可 以 使 用 Selenium 编写 针对 浏览 器 用 户 界面 的 用 
户 验收 测试 ， 并 实施 自动 化 。 重 复 上 述 测试 即 等 同 于 实施 了 回归 测试 ， 
这 样 就 不 必 再 担心 退化 的 发 生 ， 能 够 放心 地 对 代码 进行 重 构 。 在 借助 
Selenium 确保 对 外 的 用 户 界面 不 变 的 基础 上 ， 内 部 逐渐 转变 设计 ， 分 制 
为 能 够 测试 的 类 。 这 样 既 能 逐渐 提高 质量 ， 添 加 新 功能 的 速度 也 会 相应 
加 快 

使 用 Selenium 进行 用 户 验收 测试 的 相关 内 容 ， 会 在 第 7 章 进行 详细 
讲解 。 

















@…… 修改 bug 或 添加 新 功能 的 情况 


无 论 是 一 开始 就 编写 了 测试 代码 这 样 洱 运 的 工程 ， 还 是 没有 测试 代 
但 这 样 悲 惨 的 遗留 工程 ， 都 会 在 修改 bug 或 者 增加 新 功能 时 添加 代码 。 
这 时 请 一 定 要 编写 测试 代码 。 修 改 bug 的 话 ， 可 以 仅 以 修改 的 函数 为 对 
象 添加 数 行 测试 代码 。 千 里 之 行 始 于 足下 。 即 便 只 是 一 点 一 点 地 积 索 测 
试 代 码 ， 也 总 有 一 天 会 覆盖 全 体 代 码 。 

编写 测试 代码 还 涉及 工程 的 文化 层面 。 也 就 是 说 ,缺乏 测试 的 工程 
是 没有 编写 测试 文化 的 工程 。 为 了 改变 这 样 的 文化 ， 实 际 编写 测试 代码 
并 展现 其 效果 是 最 好 的 办 法 。 因 此 在 修改 bug 或 添加 新 功能 时 请 一 定 要 
编号 测试 代码。 

















seeeeeeeeseeeeseeeseseeeeeeeeeeseeeeseseeeseeeeeseeeeeeeeeeeseeeeseeeseeeeeeeeeeeeeeeee 


为 了 对 和 RDBMS 或 外 部 系统 的 API 耦合 的 部 分 这 种 比较 难 测试 的 
部 分 进行 测试 ， 这 里 介绍 一 些小 技巧 。 


e…… 和 外 部 系统 有 交互 的 测试 


连接 RDBMS 等 数据 库 的 部 分 ， 或 者 调用 Twitter 、Facebook 的 API 
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的 部 分 等 ， 编 写 依赖 于 应 用 程序 外 部 状态 的 测试 是 比较 困难 的 。 这 部 分 
的 测试 要 怎么 写 才 好 呢 ? 





@…… 使 用 mocking 框架 进行 测试 





关于 这 部 分 测试 ， 单 元 测试 基本 上 是 利用 模拟 对 象 (mock) 或 桩 程 
序 (stub) 进行 测试 的 。 

例如 ,可 以 使 用 名 为 Mockitou 的 mocking 框架 来 模拟 连接 数据 库 的 
部 分 。 大 致 的 代码 如 下 所 示 “。 


// 检查 数据 库 中 的 用 户 的 年 龄 是 否 满 18 岁 
// 编写 Authrization 类 的 单元 测试 





// 将 数据 库 连 接 对 象 转换 为 nock 对 象 

User mocked = mock (User.class) 

// 根据 测试 目的 设置 mock 对 象 的 返回 值 

when (mocked .getAge()) .thenrReturn (16) ; 

// 在 测试 对 象 中 注入 mock 对 象 并 开始 测试 

Authorization auth = new Author1izat1lion(mocked) ; 
// 确认 年 龄 检查 的 结 


assertThat (auth.proveAge(), is(false) 


mock、when、thenReturn 都 是 Mockito 提供 的 方法 。 这 里 建立 
User 类 的 mock 对 象 ， 在 该 对 象 的 getAge 方法 被 调用 时 ， 返 回 值 定 义 为 
16。 这 里 不 青 做 更 详细 的 说 明 ， 上 述 测试 代码 的 写法 还 是 相当 直观 、 另 
懂 的 。Mockito 是 一 球 功 能 强大 的 mock 框架 ,详细 的 使 用 方法 请 参考 
相关 资料 。 

这 样 ， 本 来 不 得 不 根据 测试 用 例 来 修改 数据 库 值 的 地 方 ， 借 助 
mock 框 染 便 不 必 实 际 修改 数据 库 ， 使 用 mock 对 象 就 能 够 编写 测试 。 

虽然 没有 列举 示例 代码 ， 但 和 Web 服务 的 API 相关 的 部 分 同样 可 
以 使 用 Mockito 来 模拟 。 例 如 ， 可 以 为 连接 Web 服务 的 类 制作 mock， 
使 其 返回 固定 的 JSON 作为 响应 。 

CI 中 ， 由 于 同一 测试 要 持续 地 、 反 反复 复 地 执行 ， 因 此 无 论 执 行 几 














http://mockito.org/ 

这 里 的 示例 代码 非常 简单 。 在 实际 工程 中 编写 这 样 的 mock 的 测试 代码 时 ， 对 象 类 
中 获取 外 部 数据 的 部 分 需要 能 够 简单 地 替换 成 mock， 需 要 具备 DI ( Dependency 
Injection ) 的 机 制 。DI 的 形式 多 种 多 样 ， 这 方面 可 以 参考 相关 资料 。 


SO 
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次 都 必须 返回 相同 的 结果 。 数 据 库 是 将 状态 持久 化 的 工具 ， 所 以 反复 执 
行 测试 的 话 ， 数 据 库 的 状态 会 发 生变 化 。 防 止 这 一 问题 的 方法 之 一 就 是 
mock。 如 前 所 述 ，mock 能 够 提高 单元 测试 的 效率 ， 不 仅 是 数据 库 关 联 
的 测试 ， 调 用 外 部 Web 服务 API 的 测试 同样 可 以 使 用 。 

如 果 不 使 用 mock 框架 ， 也 可 以 在 每 次 进行 测试 时 启动 数据 库 、 建 
六 数据 库 、CREATE 表格 、 加 载 数据 ， 测 试 结束 后 再 将 数据 库 删 除 。 已 
经 存在 大 量 代 码 没 有 测试 的 情况 下 ， 添 加 mock 的 机 制 比较 困难 ， 因 此 
多 采用 上 述 方法 。 

例如 ， 在 使 用 Selenium 实施 用 户 验收 测试 时 ， 比 起 使 用 mock， 使 
用 真正 的 数据 库 进 行 测试 或 许 更 有 价值 。 用 户 验 收 测试 中 数据 库 连 接 是 
否 成 功 本 映 也 是 需要 测试 的 项 目 之 一 ， 多 数 情 况 下 ， 表 之 间 复 杂 的 状态 
迁移 也 需要 进行 测试 。 并 且 在 进行 用 户 验 收 测试 时 ， 如 采 要 将 所 有 的 相 
关 对 象 都 mock 化 ,那么 所 涉及 的 数据 条 数 以 及 表 的 数量 实在 太 大 ， 实 
际 上 很 难 做 到 。 

这 样 的 情况 下 只 能 采取 在 每 次 测试 时 构建 并 删除 数据 库 的 方法 。 由 
于 这 样 的 处 理 非常 费时 ， 测 试 的 速度 也 会 由 此 变 慢 。 并 且 在 真实 的 数据 
库 上 建立 这 样 的 机 制 要 耗费 不 少 的 时 间 和 精力 “。 
































e@…… 使 用 内 存 数 据 库 进 行 测试 


这 里 有 必要 考虑 使 用 一 款 名 为 H2 的 数据 库 。 它 是 用 Java 编写 的 轻 
量 级 的 数据 库 引 擎 ， 文 持 内 存 数据 库 模 式 。 使 用 H2 能 够 使 得 重量 级 的 
数据 库 构筑 处 理 变 得 轻便 ， 测 试 的 范围 也 得 到 了 相应 的 拓展 。 需 要 注意 
的 是 ，H2 无 法 文 持 各 个 RDBMS 的 独特 的 检索 语法 ， 关 于 这 一 点 ， 可 
以 在 中 间 加 一 层 Hibernate 这 样 的 O/R 映射 工具 ， 来 吸收 各 个 数据 库 之 
间 的 差异 。 

现代 的 Web 应 用 程序 框架 应 该 能 够 根据 运行 时 的 配置 更 改 数据 库 的 
连接 。 例 如 Play Framework 在 执行 测试 时 默认 使 用 H2 连接 数据 库 并 








QD 这样 的 情况 下 可 以 使 用 DbUnit 等 工具 ， 虽 然 这 些 工具 有 些 旧 了 ， 但 还 是 多 少 能 
够 节省 一 些 时 间 。 
@ 当然 配置 可 以 修改 。 
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日 还 提供 了 名 为 Fixture 的 数据 加 和 载 机 制 。 借 助 该 机 制 ， 执 行 测试 时 就 
可 以 用 和 正式 环境 相同 的 步骤 ,在 内 存 上 高 速 地 构建 数据 库 和 表 ， 加 载 
数据 ， 在 此 基础 上 ， 编 写 的 测试 用 例 也 能 够 以 和 正式 环境 相同 的 方式 来 
访问 数据 。 因 为 是 内 存 数据 库 ， 所 以 能 够 在 测试 结束 后 轻易 地 销毁 。 测 
试 也 因此 具备 了 很 高 的 独立 性 。 写 过 测试 代码 的 各 位 一 定 知道 ， 和 数据 
库 紧 密 硒 合 的 话 ， 每 次 测试 后 数据 库 状态 都 会 发 生变 化 ， 因 此 测试 非常 
难 写 。 而 内 存 数 据 库 将 很 大 程度 地 改善 这 个 问题 。 























e…… 数据 库 变 更 管理 和 配置 文件 管理 的 测试 


如 第 3 章 中 所 提 到 的 那样 ， 在 利用 数据 库 迁 移 机 制 进行 数据 库 的 变 
更 管理 的 情况 下 ，SQL 的 正确 与 否 可 以 通过 表 的 生成 是 否 正 确 来 判断 ， 
但 应 用 程序 的 动作 是 否 正确 还 不 得 而 知 。 

数据 库 迁 移 自身 的 测试 也 可 以 简单 地 写 一 下 。 数 据 库 构 筑 完成 后 ， 
写 一 下 简单 的 冒 烟 测 试 ,只 要 能 够 确认 应 用 程序 的 基本 部 分 运行 正常 就 
可 以 了 。 

环境 构建 部 分 的 测试 同样 也 是 写 一 下 比较 好 。 中 间 件 启动 后 ， 确 认 
下 是 否 有 响应 ， 即 使 是 这 样 简单 的 测试 ， 也 是 非常 有 效 的 。 关 于 使 用 
Chef 或 serverspec 的 环境 构建 自动 化 以 及 相关 的 测试 详情 ， 我 们 将 在 第 
6 章 讲 述 。 

数据 库 的 变更 管理 也 好 ， 环 境 配置 管理 也 好 ， 为 测试 这 些 项 目 ， 严 
密 地 说 需要 在 这 些 项 目的 基础 上 来 确认 应 用 程序 的 所 有 动作 。 从 这 个 意 
义 上 来 说 ， 如 果 要 对 这 方面 进行 严密 的 测试 的 话 ， 通 过 用 户 验 收 测试 来 
确认 是 比较 正确 的 做 法 。 当 然 也 要 根据 工程 的 状况 、 预 算 以 及 期 限 适度 
地 编写 测试 。 






































@…… UI 相关 的 测试 


UI 相关 的 测试 是 比较 困难 的 部 分 。 因 此 要 尽 可 能 地 将 业务 逻辑 内 聚 
在 MVC 模式 中 的 M (模型 ) 中 ,设计 为 不 必 涉 及 UI 就 能 网 罗 几 乎 所 





QD 简单 的 动作 确认 测试 。 为 了 确认 是 否 能 够 实施 正式 的 测试 而 进行 的 准备 性 质 的 测 
试 。 原 本 是 电机 行业 的 术语 ， 指 将 冰箱 、 电 视 机 等 接 通 电源 看 看 有 没有 冒 烟 。 
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有 的 测试 用 例 。 应 该 尽量 避免 编写 依赖 于 UI 的 测试 。 

最 近 使 用 充分 挖掘 了 Ajax 特性 的 Rich UI 的 Web 应 用 程序 也 开始 
多 了 起 来 。 随 之 而 来 的 是 ，JavaScript 的 MVC 框架 也 开始 大 量 出 现 。 如 
果 在 客户 端 较 多 地 使 用 了 JavaScript 的 话 ， 应 该 尽量 将 业务 逻辑 内 聚 在 
M 之 中 ， 以 便 可 以 通过 UI 以 外 的 部 分 进行 测试 。 

不 得 不 针对 UI 编写 测试 的 情况 下 ， 可 以 利用 Selenium 这 样 的 工具 
来 实现 用 户 验 收 测试 的 目 动 化 。 使 用 Selenium 的 用 户 验 收 测试 自动 化 的 
相关 内 容 将 在 第 7 半 详 细 讲 解 。 














e…… 未 手 的 测试 要 权衡 工 数 


编写 和 外 部 交互 相关 的 测试 或 数据 库 变 更 管理 、UI 相关 的 测试 等 相 
当 杯 手 的 测试 目 然 会 耗费 相当 多 的 工 数 。 如 末 只 考虑 质量 的 话 ， 这 些 测 
试 的 确 是 完整 地 写 一 下 比较 好 ,但 实际 上 编写 测试 可 用 的 时 间 并 不 是 无 
限 的 。 

测试 的 目 动 化 是 越 做 越 耗费 时 间 和 精力 。 将 编写 测试 所 获得 的 质量 
提升 以 及 能 够 在 未 来 消减 的 工 数 ， 与 编写 测试 实际 耗费 的 工 数 进行 权 
衡 ， 注 章 保 持 两 者 的 平衡 。 

如 果 过 度 执 着 于 测试 自动 化 的 工作 ， 其 本 号 束 像 填 字 游戏 一 样 ， 里 
然 有 趣 ， 但 不 知 不 党 之 中 就 可 能 做 过 了 头 ， 投 入 和 回报 不 相符 了 。 

请 大 家 根据 目 吴 所 处 的 状况 ， 以 及 项 目 所 追求 的 价值 ， 在 最 合适 的 
限度 内 来 实现 测试 的 目 动 化 。 
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5.4 执行 基于 Jenkins 的 CI 


已 经 集 齐 了 所 需要 的 版 本 管理 系统 、 自 动 build 以 及 测试 代码 之 后 ， 
接 下 来 就 让 我 们 实际 使 用 Jenkins 来 实施 CI 吧 。 





5.4.1 Jenkins 的 安装 





Jenkins 的 安装 非常 简单 。 从 主页 “下载 WAR 文件 并 执行 以 下 命令 
即 可 。 


$ java -jar jenkins.war 


启动 Jenkins 后 访问 http://1Localhost:8080， 在 显示 如 图 5.7 
这 样 的 画面 ， 即 说 明 安 装 成 功 了 。 
图 5.7 ”Jenkins 安装 完成 画面 
伟 Jenkins 





Jenkins 





营 ”新建 

筷 及 欢迎 使 用 Jenkins'! 
区 任务 历史 

KX 系 纺 乱 理 | Fa 多 建 -个 新 作 务 


过 Credentials 


构建 队列 一 
队列 中 没有 构建 任务 


生成 页 画 : 2014-11-23 18:09:44 ”RESTAPI Jenkins ver 1.590 

















DD http://jenkins-ci.org/ 
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e…… 使 用 本 地 安装 包 进行 安装 


在 刚才 的 例子 中 ， 为 了 体现 启动 Jenkins 有 和 多么 简单 ， 选 择 了 直接 
使 用 WAR 包 启 动 。 而 在 实际 的 开发 现场 ， 则 是 将 Jenkins 作为 OS 的 服 
务 ( UNIX/Linux 环境 的 守护 程序 ) 启动 比较 好 。Jenkins 为 各 个 OS 提 
供 了 安装 包 。 例如， 使 用 Windows 平 台 的 安装 包 进 行 安装 就 能 作为 
Windows 的 服务 启动 ， 使 用 CentOS 的 安装 包 就 能 作为 Linux 的 驻守 程 
序 启动 。Jenkins 的 主页 上 记载 有 各 个 OS 的 本 地 安装 包 的 安装 方法 ， 可 
以 参考 。 

这 里 以 Red Hat Enterprise Linux 为 例 进 行 讲解 。 新 建 Jenkins 用 的 目 
录 并 执行 yum 命 令 即 可 。 启 动 脚 本 也 会 一 并 安装 。 


$ woet -0O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins-ci.org/redhat/ 




















Jenkins .repo 
$ rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key 
$ yum install jenkins 


执行 如 下 命令 ， 即 可 将 Jenkins 作为 OS 的 守护 程序 启动 。 
$ /etc/rc.d/init.d/jenkins start 
和 使 用 WAR 启动 时 一 样 ， 启 动 后 请 试 着 访问 http://localhost: 
8080， 奋 显示 如 图 5.7 这 样 的 画面 ， 即 说 明 安 次 成 功 。 
顺便 提 一 下 , Jenkins 还 能 在 Tomcat 等 Servlet 容器 上 启动 。 这 时 会 
监听 ajp 的 8009 端口 ， 所 以 用 proxy ajp 等 作为 代理 上 传 至 服务 需 即 可 。 











5.4.2 ”Jenkins 能 干 些 什么 


seeeeeeeeseeeeeeeseeeeseeeeseeseeseeeseeseeseseseeeeeeeeseeeeeseeseeseeeeeeeeeeseeeeeeeeseeeeeeee 





Jenkins 是 一 款 为 实施 CI 提供 文 持 的 工具 ， 通 过 和 各 类 插件 组 合 使 
用 ， 可 以 实现 非常 丰富 的 功能 。 详 细 内 容 可 以 参考 Jenkins 相关 的 书籍 “。 

这 里 对 Jenkins 所 支持 的 最 基本 的 CI 进行 说 明 。 先 前 列举 了 CI 所 
必需 的 版 本 管理 系统 、build 工具 、 测 试 代 码 ， 将 这 些 组 合 起 来 构建 如 下 
这 样 的 机 制 。 

















(D http://tomcat.apache.org/ 
(2 John Fereuson Smart 著 ，Jenkins: The Definitive Guide, O’ Reilly Media, Inc, USA， 
2011 
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@ 下 载 ( checkout ) 代码 
e@ 自动 build 并 执行 测试 
e@ 统计 结果 并 制作 报表 
@ 通知 


让 我 们 试 着 来 建立 一 种 机 制 ， 实 现 当 代码 有 更 新 时 能 够 立即 并 且 持 
续 地 执行 上 述 一 系列 处 理 。 





5.4.3 新建 任务 





seeeeeeeeseeseseeeeeseeseeeeeeeseeseeseeeseeseeseeseeeeeseeeseeeseeeeseeeeeseseeeeeeseseeeseeeseeseeeseeeeeeeseeseeseeeseeseeeseeseeeseeeseeeeeeeeeeeee 


Jenkins 以 任务 (Job ) 为 单位 来 管理 一 系列 的 处 理 流 程 。 可 以 姑且 
理解 为 1 个 应 用 对 应 1 个 任务 , 或 者 1 个 目录 对 应 1 个 任务 “。 

首先 在 Jenkins 上 新 建 任务 。 点 击 末 单 上 的 “创建 一 个 新 任务 ”"， 会 
出 现 “ 构 建 一 个 自由 风格 的 软件 项 目 ”“ 构 建 一 个 Maven2/3 项 目 ”“ 构 
建 一 个 多 配置 项 目 ”“ 监 控 一 个 外 部 的 任务 ”“ 复 制 已 有 的 Item”5 个 选 
项 ， 这 些 选 项 各 自 的 内 容 在 Jenkins 的 主页 上 都 有 说 明 ， 请 自行 参考 。 

如 果 使 用 Maven bulid 工程 的 话 ， 可 以 选择 “构建 一 个 Maven2/3 项 
目 "。Jenkins 支持 癌 Maven 目录 公开 ( publish ) 所 生成 的 文件 之 前 的 流 
程 。 而 如 果 是 Ruby、Node.js 等 Java 之 外 的 项 目 ， 或 者 是 使 用 Maven 以 
外 的 Java 项 目 ， 请 选择 “构建 一 个 自由 风格 的 软件 项 目 ”。 











5.4.4 下 载 代码 


下 面 进行 从 版 本 管理 系统 下 载 ( checkout ) 代码 的 配置 。 虽 然 这 里 
写 的 是 “代码 ”， 但 是 应 该 进行 版 本 管理 的 并 不 仅 限 于 代码 ， 还 包括 数 
据 库 模 式 的 定义 和 配置 文件 等 应 用 程序 启动 所 需 的 所 有 资源 。 用 Jenkins 
将 这 些 资源 下 载 到 干净 的 环境 。 

上 述 内 容 在 代码 管理 这 一 项 目 中 进行 配置 。Jenkins 默认 可 选 的 代码 
管理 系统 为 CVS 和 Subversion， 使 用 其 他 的 版 本 管理 系统 需要 安装 插件 。 

这 里 以 使 用 Git 作为 前 提 进 行 讲解 。 点 击 菜 单 中 的 “系统 管理 "， 打 


(D 实际 上 1 个 任务 也 可 以 操作 多 个 目录 ， 通 过 配置 可 以 实现 各 种 不 同 的 运用 。 
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开 “ 管 理 插 件 ”， 在 “可 选 插件 ”标签 下 查找 名 为 “Git Plugin” 的 项 目 
(图 5.8 )。 


图 5.8 Git Plugin 





多 Jenkins 
Jenkins 插件 管理 


会 返回 过 源 : [& Git Plugin 








ZS 系统 管理 可 更 新 ” 可 选 插件 。 已 安装 ”高 级 
安 版 
装 | Se 本 
Git Parameter Plugin 032 
This plugin allows you to choose between Git tags or sha1 of your SCM repository so Git Plugin installed is required 
Git Chooser Alternative Plugin 11 








An alternative build chooser plugin for the Jenkins git plugin 


Team Concert Git Plugin 


Integrates Jenkins with Rational Team Concert for Jenkins Builds which use Git as source control. This plugin will ee 































traceability link n a Jenkins build to Rational cert Work ltems and build r y links 1039 
from a Jenkins build to an RTC build result. lt also p links to work items and annotat e y 
Jenkins with links to RTC Tk ltems; lt leverages the current RTC features and workflows that users are already familiar with such 
as, emails, toaster popups, reporting, dashboards, etc 
— Tracking Git Plugin 于 
= Lets one project track the Git revisions that are built for another project 
Git Plugin 
V This plugin allows use of Git as a build SCM. A recent Git runtime is required (1.7.9 minimum, 1.8.x recommended). Plugin is only 2.3 





tested on official git client. Use exotic installations at your own risks 


直接 安装 下 载 竺 重启 后 安装 


点 击 “ 下 载 待 重启 后 安装 ”按钮 ， 重 启 Jenkins， 完 成 安装 。 再 次 打 
J DD 可 以 看 到 增加 了 名 为 
Git 的 选项 。 按 照 图 5.9 进行 配置 。 


5.9 Git 的 配置 




















源码 管理 
© None 
© CVS 
© CVS Projectset 
© Git 
Repositories - 
Repository URL github.com/Shanon/DeeElle git @@ 
Credentials 四 
-none - 
S= Add © 
高 贫 -- 
Add Repository Delete Repository 
Branches to build ; i 
Branch Specifier (blank for ‘any’) | © 
Add Branch Delete Branch 
浏 监 
源码 库 浏览 器 githubweb 四 @ 
URL BE 
https://github.com/Shanon/DeeElle/ 
on 
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图 5.9 中 ， 在 “Repository URL” 中 填写 Git 的 URL， 在 “Branches 
to build” 中 填写 build 对 象 的 分 支 名 称 。 然 后 在 “源码 浏览 各 ”处 填 与 
阅览 Git 时 使 用 的 工具 ， 这 里 选择 了 githubweb， 其 他 还 有 Gitlab 和 
Gitrious 等 选项 。 


5.4.5 有 目 动 执行 build 和 测试 


seeeeeeeeeseeeeeeseeeseeeseeseeseeeseeseeeeeseseeeseeeeeseeseeeeseeeeeseeseeseeeseeeeeseeeeeeeeee 


下 面 对 build 进行 配置 。 分 别 对 “构建 触发 需 ” 和 “构建 (build 了 
进行 设置 。 
在 “构建 触发 需 ” 中 配置 执行 build 的 触发 右 。 


e@…… 定期 执行 


比如 工 天 执行 1 次 、 每 隔 4 小 时 执行 1 次 等 ， 设 置 为 定期 自动 执行 
build 的 方式 。 可 以 用 近似 于 cron 的 写法 来 设置 执行 的 频率 。 

定期 执行 是 从 还 没有 CI 这 个 词汇 时 就 有 的 手法 。 例 如 Joel on 
Sofiware" 中 写 到 了 Microsoft 从 1990 年 代 开 始 1 天 进行 1 次 build ( daily 
build )。 还 有 描写 1990 年 代 初 Windows NT 的 开发 的 《 观 止 微软 创 
建 NT 和 未 来 的 夺 命 狂奔 》 ， 其 中 也 提 到 了 daily build。 

daily build 严格 来 说 并 不 是 CI， 但 配置 简单 ， 实 施 起 来 也 算是 不 错 
的 方式 。1 天 之 内 提交 的 量 并 不 是 太 多 的 话 ， 进 行 daily build 也 不 会 有 
什么 问题 。 也 有 一 些 案例 是 因为 build 或 测试 的 执行 时 间 过 长 ， 导 致 无 
法 及 时 build 而 不 得 不 采用 daily build 的 方法 。 定 期 执行 作为 CI 来 说 虽 
然 有 所 欠缺 ,但 比 起 什么 都 不 做 来 说 还 是 要 好 很 多 的 。 





























@…… 轮 询 版 本 管理 系统 


即 配置 为 以 轮 询 (polling ) 的 方式 监视 版 本 管理 系统 ， 有 新 的 提交 
( Push ) 时 就 执行 build 的 方式 。 能 够 用 类 似 于 cron 的 写法 来 指定 轮 询 的 








(DD) Avram Joel Spolsky, Joel on Sofitware, APress，2004 年 
QQ 《 观 止 一 一 微软 创建 NT 和 未 来 的 村 命 狂 奔 》G. Pascal Zachary 著 ， 张 银 奎 译 ， 机 
械 工 业 出 版 社 ，2009 
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频率 。 由 于 在 每 次 提交 时 都 会 进行 build 及 测试 ， 因 此 能 够 更 早 地 发 现 
问题 ， 有 助 于 质量 的 提高 。 

因为 采取 的 是 轮 询 的 方式 ， 所 以 无 论 是 否 有 提交 都 会 器 版 本 管理 系 
统 发 送 请 求 。 虽 然 这 会 给 系统 造成 不 必要 的 负担 ,但 只 要 没有 太 大 的 问 
题 ， 采 用 轮 询 的 方式 还 是 能 够 比较 方便 地 实施 CI 的 。 

build 执行 的 频率 增加 后 ，build 的 速度 就 变 得 很 重要 。 过 于 缓慢 的 
话 ， 提 交集 中 时 ，build 会 积累 在 任务 队列 中 ， 变 得 难以 及 时 地 察觉 问 
题 。 为 了 避免 这 样 的 情况 ， 就 需要 在 build 或 测试 代码 上 下 功夫 ， 提 高 
CI 服务 需 的 处 理 速度 ， 增 加 服务 器 台数 实行 并 行 build 等 。 

尽 可 能 地 避免 定期 执行 ， 以 每 次 提交 时 进行 build 这 样 的 循环 来 实 
施 CI 是 很 重要 的 ， 因 为 这 样 版 本 管理 系统 的 提交 记录 和 CI 服务 需 的 
build 结果 就 能 关联 起 来 ， 工 程 的 可 追溯 性 能 够 得 到 提高 。 














-一 专栏 ”从 版 本 管理 系统 进行 Push 


从 Jenkins 的 配置 来 说 ,“ 轮 询 版 本 管理 系统 ”是 最 适合 于 C| 
的 ， 但 最 好 能 够 由 版 本 管理 系统 通过 Push 来 请 求 Jenkins 执行 
build。Git 和 Subversion 都 能 够 配置 Push， 这 里 介绍 下 使 用 Git 的 
pn 

Git 提供 了 在 发 生 提交 或 收 到 Push 等 事件 时 执行 特定 脚本 这 样 
的 钧 子 ( hook ) 的 机 制 。 在 各 个 代码 库 下 的 .git/hooks/ 目录 下 有 示 
例文 件 ， 编 写 自己 的 脚本 时 可 以 进行 参考 。 详 细 内 容 请 见 Pro Git"。 
Subversion 也 有 钩子 的 机 制 ， 可 以 实现 相同 的 功能 。 

例如 ， 在 代码 被 Push 到 Git 代码 库 时 ， 若 要 执行 Jenkins 的 任 
务 ， 可 以 建立 .git/hooks/post-receive 文件 ， 并 按照 下 面 的 内 容 进行 
编辑 。 上 述 处 理 是 以 安装 Jenkins 的 Git Plugin 为 前 提 的 。 


Sl /DLA Bh 

curl http://{Jenkins 服务 器 的 域名 或 IP 地 址 等 }/jenkins/ 
git/notifyCommit?url={Git 代码 库 的 URL} &branches={ 分 支 名 ( 可 以 设置 
多 个 了 


cur| 部 分 也 可 以 是 wget 等 命令 ， 只 要 配置 后 能 够 向 Jenkins 发 








JJ http://git.oschina.net/progit/ 
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送 上 述 这 样 的 GET 请 求 即 可 。 

通过 上 述 配 置 ， 在 Git 代码 库 收 到 Push 时 就 会 向 Jenkins 发 送 
上 述 GET 请 求 。 收 到 请 求 的 Jenkins 会 执行 包含 对 应 代码 库 的 所 有 
任务 。 关 于 这 个 功能 的 详细 内 容 请 参考 Git Plugin 的 帮助 “。 

如 果 使 用 的 是 GitHub 的 话 ， 可 以 利用 GitHub 的 Service Hooks 
设置 。 打 开 代 码 库 Settings 下 的 Service Hooks 就 能 看 到 ，GitHub 
能 够 和 全 世界 的 各 类 服务 进行 交互 ( 图 5.a )。 


图 5.a Service Hooks 





© 加 This repository ~ Search ortype a command @ 和 Explore Gist Blog Help en ikeike443 区 
发 Shanon / DeeElle 
二 
0Q. 
Options AVAILABLE SERVICE HOOKS 
WebHook URLs (0) (ep Service hooks share your commits with other apps 
Teams 
ActiveCollab 
Service Hooks Acunote 


Deploy Keys AgileBench 














Baseca mp Plus 134 other apps! 


从 中 选择 Jenkins， 并 配置 好 Jenkins 的 URL， 就 能 同样 在 
GitHub 收 到 Push 时 向 Jenkins 发 送 执行 任务 的 请 来 。 但 是 需要 注 
意 的 是 要 将 Jenkins 搭建 在 GitHub 可 见 之 处 。 通 常 Jenkins 多 被 搭 
建 在 公司 内 部 的 局 域 网 ( LAN ) 中 ， 所 以 需要 在 网 络 的 配置 上 下 一 
些 功夫 。 顺 便 提 一 下 ，GitHub 发 送 请 求 的 服务 器 IP 地 址 是 公开 的 ， 
只 要 对 Jenkins 加 上 IP 限制 ， 就 能 够 消除 安全 方面 的 隐患 。 

这 样 的 方法 能 够 消除 延迟 ， 实 现在 每 次 提交 后 立即 实施 build。 











@…… build 的 记述 


下 面 来 讲 一 下 build 以 及 测试 的 处 理 。 可 以 在 “增加 构建 步骤 ”中 
选择 Ant、Maven、shell 脚本 、Windows 批 处 理 文 件 中 的 任意 一 项 。 
Java 的 项 目 可 以 选择 Ant 或 Maven。 


https:Wwiki.jenkins-ci.oreg/display/JENKINS/Gittplugin 
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如 有 果 是 Java 以 外 的 语言 的 话 ， 可 以 用 shell 脚本 来 记述 build 的 处 
理 。 使 用 Make、Rake 或 SBT 等 build 工 具 的 话 也 没有 问题 。 虽 然 在 
Jenkins 的 配置 页 面 上 能 够 直接 编辑 shell 脚本 ,但 还 是 建议 将 build 脚本 
记录 在 文件 中 并 提交 到 版 本 管理 系统 ， 在 Jenkins 中 只 做 简单 的 调用 。 这 
样 即便 没有 Jenkins， 也 能 够 以 完全 相同 的 方法 来 执行 build， 非 常 方便 。 

另外 ， 如 果 不 使 用 build 工具 ， 而 是 利用 shell 脚本 来 描述 build 的 
话 , 请 设置 相 适 应 的 退出 值 ( exit code ) ”。Jenkins 根据 该 值 来 判断 任务 
的 执行 是 失败 还 是 成 功 。 

















5.4.6 ”统计 结果 并 生成 报表 


可 以 在 “构建 后 操作 ”中 选择 结果 的 通知 方式 。 

可 选 的 项 目 各 种 各 样 ， 这 里 为 了 便于 统计 测试 结果 ， 请 选择 
“Publish JUnit test result report”。 随 后 就 会 出 现 设置 测试 结果 XML 文件 
的 路 径 的 输入 框 ， 输 入 测试 结果 XML 文件 的 路 径 即 可 。 这 样 配置 后 再 
进行 build， 就 能 如 图 5.10 这 样 在 浏览 器 上 确认 结 


图 5.10 ”测试 结果 


seeeeeeeeseeeeeeseseeeseeseeeeseeseeseeseeeeseeeeeeseeseeeeeeeeeeeseeeeeseeeeeeeeeeseeeeeee 



















































































VE 
测试 结果 
失败 5 个 (+5)， 跳 过 8 个 ( +0) 
[a 
253 个 测试 ( +0 ) 
所 用 时 间 34 
食 添 加 说 明 
所 有 失败 的 测试 
测试 名 测试 所 用 时 间 时 期 
>>> jp.co.shanon.ss.api.services.ApplicationTest.testPost UpdateCheckTypeAttribute 1.9 秒 1 
jp.co.shanon.ss.api.services.BulkApiTest.testPostAndGetBulkApi 2.2 秒 1 
>>> ip.co.shanon.ss.api.services.VisitorFileTest.testPostAllCondition 0.67 秒 1 
>>> jp.co.shanon.ss.api.services.VisitorTest.testUpsert_Post 1.1 秒 1 
>>> ip.co.shanon.ss.api.services.VisitorTest .testUpsert Put 1.8 秒 下 
所 有 测试 
包 测试 所 用 时 间 ”失败 (差分 ) 跳 过 (差分 ) 合计 (差分 ) 
j i i 34 分 5 +5 8 251 
6ms 0 0 2 

















从 图 5.10 中 可 以 看 出 ，253 个 测试 中 有 5 个 测试 失败 了 。 测 试 所 消 
耗 的 时 间 也 能 从 图 上 看 出 。 从 “时 期 ”这 一 列 可 以 知道 这 是 从 在 此 之 前 
的 第 几 次 build 开始 出 现 失败 的 ， 图 5.10 中 的 5 个 测试 都 是 在 这 次 build 


(D 成功 的 话 返回 “exit 0"”， 失 败 的 话 返回 “exit9”。 
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中 才 失 败 的 。 其 他 还 有 一 些 针 对 包 的 测试 ， 可 以 看 出 和 上 一 次 build 相 
比较 ， 失 败 的 个 数 有 所 增加 。 





-一 专栏 以 JUnitXML 的 形式 输出 报表 比较 高 效 


通过 使 用 插件 ， 还 可 以 对 JUnitXML 之 外 的 测试 结果 进行 统计 。 
但 考虑 到 通用 性 和 报表 的 直观 性 ， 以 JUnitXML 形式 输出 的 报表 是 最 
有 效 的 。 如 果 使 用 的 测试 框架 是 JUnit 的 话 自 然 没 有 问题 。 如 果 使 用 
的 是 其 他 测试 框架 ， 因 为 报表 生成 部 分 的 实现 大 多 能 以 插件 的 形式 
进行 替换 ， 所 以 这 里 推荐 修改 为 以 JUnitXML 的 形式 来 生成 报表 。 

例如 Scala 的 Specs2 就 能 够 通过 修改 配置 来 改变 生成 报表 的 形 
式 。JavaScript 的 Jasmine 也 有 志愿 者 制作 的 名 为 JUnitXmlReporter 
的 输出 JUnitXML 的 对 象 ” 其 他 的 语言 也 基本 都 能 够 输出 JUnitXML， 
因此 建议 先 调 查 清楚 再 着 手 应 对 。 








5.4.7 ”统计 覆盖 率 


至 此 ， 我 们 实现 了 到 统计 持续 build 及 测试 结果 为 止 的 处 理 流程 。 
通过 自动 执行 测试 ， 对 于 测试 覆盖 的 部 分 就 能 够 确认 测试 是 否 成 功 ， 但 
测试 没有 禾 盖 的 部 分 就 没有 任何 信息 。 这 样 的 情况 下 ， 让 我 们 来 统计 一 
下 代码 履 盖 率 ( code coverage )。 人 代码 履 盖 率 是 表示 测试 对 象 的 应 用 程 
序 代码 在 测试 中 被 执行 了 多 少 的 指标 。 统 计 和 畴 盖 率 能 够 看 出 代码 被 测 
试 的 程度 ， 或 者 反 过 来 说 ， 能 够 使 还 需要 增加 多 少 测试 这 样 的 信息 可 
倪 化 。 

但 需要 注意 的 是 ， 代 人 码 履 盖 率 只 是 反映 了 测试 对 和 象 的 应 用 程序 代码 
是 否 被 执行 ， 并 不 能 反映 出 用 作 测 试 的 测试 代码 是 否 妥 当 ， 因 此 并 不 可 
以 盲目 相信 。 但 在 认识 到 需要 通过 代码 审阅 ( source review ) 等 方式 来 
确保 测试 代码 的 内 容 的 正确 性 之 后 ， 代 人 码 和 覆盖 率 作为 质量 指标 之 一 会 变 
得 很 重要 ， 所 以 请 一 定 要 试 着 用 一 下 。 





seeeeeeeeeeeeeeeeeeeseeseeseeeeseeseeeeeeeseeesseeeeseeseeeeeeeseeseseeseeeeseeeseeeeeseeseeeseeeeeeeseeeeeeeeeeeeeeee 






































q https://github.com/larrymyers/jasmine-reporters 
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e…… 覆盖 率 统计 工具 


统计 和 窗 冀 率 需 要 安 儿 专门 的 工具 。 具 有 代表 性 的 儿 盖 率 统 计 工 具有 
下 面 这 些 。 

















® Cobertura' 
® Jacoco” 

® Scct” 

@ SimpleCov” 


@ Rcovs 


这 些 工 具 是 以 Ant、Maven 、SBT 、Rake 等 build 工具 的 插件 的 形式 
提供 的 。 可 以 根据 开发 环境 选择 合适 的 工具 。 这 次 以 作为 Maven 的 插件 
提供 的 Cobertura 为 例 进 行 讲解 “。 


@…… Maven Cobertura 插件 的 安装 


在 Maven 中 使 用 Cobertura， 只 需要 在 pom.xml 中 定义 如 下 依赖 关 
系 即 可 。 


<dependencies> 
<dependency> 
<groupId>org.codehaus .mojo</groupId> 
<artifactId>cobertura-maven-plugin</artifactId> 
<version>2.5.2</version> 
</dependency> 
</dependencies> 


依赖 关系 定义 完 后 ， 执 行 下 列 命 令 。 


mvn cobertura:cobertura 


3A 


http://cobertura.github.1i0/cobertura/ 

http://www.eclemma.org/jacoco/ 

https://github.com/sqality/scct 

https:/www.ruby-toolbox.com/projects/simplecov 

https://github.com/relevance/rcov 

Cobertura 已 经 于 2011 停止 了 开发 ， 所 以 今后 改 用 Jacoco 比较 好 。 因 为 习惯 了 用 
Cobertura 编写 报表 的 方式 ， 笔 者 个 人 比较 喜欢 使 用 Cobertura， 而 且 现 在 还 在 使 
用 。Java 之 外 的 语言 的 覆盖 率 统计 工具 也 大 都 支持 Cobertura 形式 的 XML。 


OOOOOOO 
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这 样 就 会 执行 测试 ， 并 在 测试 之 后 对 复 盖 率 进 行 统计 。 结 果 文 件 以 
html 的 形式 生成 在 target/site/cobertura/ 上 日 录 下 。 可 以 在 浏览 
售 上 打开 index.html 来 确认 报表 (图 5.11 )。 


图 5.11 覆盖 率 的 报表 

















Packages Coverage Report - All Packages 

All 

com amalLlkelke443 Package # Classes Line Coverage Branch Coverage Complexity 
All Packages 1 o% 帮 N/A N/A 
com.gmail.ikeike443 1 o% [0 N/A N/A 


Report generated by Cobertura 1.9.4.1 on 13/05/25 22:27. 








All Packages 


Classes 





App (0%) 











图 5.11 中 因为 还 没有 编写 测试 ， 所 以 覆盖 率 为 0%。 添 加 测试 后 就 
能 通过 报表 确认 禾 盖 率 上 升 。 作 为 供 人 阅览 的 报表 来 说 ， 这 样 的 HTML 
形式 确实 看 起 来 比较 方便 ， 但 就 利用 Jenkins 来 实现 CI 来 看 ， 还 是 以 计 
算 机 易于 理解 的 XML 形式 输出 文件 比较 方便 。Cobertura 的 报表 的 默认 
形式 是 HIML， 可 以 通过 修改 配置 同时 生成 XML 形式 的 报表 。 

如 下 这 样 编辑 pom.xml。 


<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http:// 
WWW.W3 .org/2001/XMLSchema-instance" 
xSsSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven. 
apache .org/xsd/maven-4.0.0.xsd"> 
<properties> 
<project .build.sourceEncoding>UTF-8</project .build.sourceEncoding> 





</properties> 
ep 市 二 We 
<plugins> 
< em 
<groupId>org.codehaus .mojo</groupId> 
<artifactId>cobertura-maven-plugin</artifactId> 
<EOnfileuUracLons 
<£OrmacsS> 
<format >xml</format> 
= ame mi 
</foOrmacte> 
/eon en 
</lueins 
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</plugins> 
</loud Lels 
<dependencies> 
©@3 
</dependencies> 
</project> 


在 这 样 的 状态 下 再 次 执行 mvn cobertura : cobertura， 就 会 
发 现 除了 之 前 的 html 文件 之 外 ， 还 生成 了 名 为 coverage.xml 的 文件 。 
这 样 履 盖 率 的 统计 就 完成 了 。 接 着 让 我 们 对 Jenkins 进行 配置 。 








一 专栏 Java 程序 库 的 查找 方法 

笔者 参与 过 数 个 开发 现场 ， 其 间 所 体会 到 的 事情 之 一 就 是 使 
用 Java 的 开发 现场 中 程序 库 的 查找 方式 以 及 安装 方法 存在 不 恰当 
的 地 方 。 

在 Web 上 检索 相关 信息 ， 下 载 可 能 符合 条 件 的 jar 文件 ， 并 将 
其 加 入 class path 使 用 ， 这 样 的 事例 意外 的 多 。 如 此 一 来 程序 库 的 可 
信 度 就 有 问题 了 。 

Perl 和 Ruby 这 样 的 脚本 语言 ， 各 个 社区 之 间 彻 底 地 应 用 了 包 
( package ) 管理 。 但 Java 不 全 是 这 样 。 脚 本 语言 从 早期 就 采取 了 包 
管理 的 机 制 ， 和 OSS 亲 和 性 比较 高 。 

Java 也 有 包 管 理 机 制 ， 如 Maven 仓库 。 访 问 http://search. 
maven.org 就 可 以 看 到 很 多 Java 系 语言 (也 包括 Scala、Groovy、 
JRuby 等 ) 的 OSS 程序 库 。 

例如 ， 搜 索 Cobertura， 可 以 找到 几 个 符合 条 件 的 程序 库 。 这 里 
试 着 使 用 一 下 Cobertura 的 Maven 插件 ( 图 5.b )。 

从 图 5.b 可 以 看 出 如 何在 Maven 的 pom.xml 中 添加 依赖 关系 来 
安装 Cobertura。 图 中 还 记载 了 使 用 Ivy 和 SBT 以 及 其 他 build 工具 
时 的 写法 ， 请 务必 参考 。 
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图 5.b ”Cobertura 的 Maven 插件 


= The Central Repository SEARCH | ADVANCED SEARCH | BROWSE | QUICKSTATS 
cobertura | 


New: App Scan Advanced Search | APlGuide | Help 


Artifact Details For org.codehaus.mojo : cobertura-maven-plugin : 2.5.2 


Click on a link above to browse the repository. 


ERTTT 


Groupld: org.codehaus.mojo 

















Feedback 


?xml version="1.0" encoding="ISO0-8859-1"2><Pzoject xmlns="httPp://maven.apache.cozq/ECOM/4， 
<modelVersion>4.0.0</modelVersion> 





Artifactld: cobertura-maven-plugin 


Version: 2.5.2 <artitactTavame oj Cpa nt</artifactId> 
<groupId>o au o</groupId> 


LS .mo 
<version> 36< pe 
Dependency Information </parent> 


<artifactId>cobertura maven-pl! 
Apache Maven | <version>2.5.2</ve rsion> 
人 ] psa maven i ugin</packaging> 





lugin</artifactId> 








<dependency> 


name>: for 
<groupId>org.codehaus .mojo</groupId> > Mojo's Maven plugin for Cobertura</name> 








0 moio.code ee Lozaycobez tura-maven -plu ugi </url> 
<arti 二 obertur po plugin</arti deacription>This Se the Mo cc 's Maven plugin for < ura. Cobertura is a free Java tc 
<version>2.5.2</version > tests. It can used to identify which parts of your Java program are lacking test ¢ 
</dependency> </des pe 
Apache Buildr <inceptionYear>2005</inceptionYear> 
ses 
Apache Ivy es 
Groovy Grape <name>The Decne SS i Jersion 2.0</name> 
Grails <url>http://www enses Ds 
<distribution>re es TEFS 
Scala SBT </license> 
</licenses> 




















i Jenkins 插件 的 配置 


在 Maven 中 执行 Cobertura 后 ， 接 着 对 Jenkins 进行 配置 。 
Jenkins 本 Cobertura 的 插件 ， 和 安装 Git 的 插件 一 样 ， 请 从 插件 
管理 进行 安 疙 。 
安装 完成 后 ， 在 任务 配置 的 构建 后 操作 中 会 增加 选项 “Publish 
Cobertura Coverage Report”， 选 中 该 项 。 在 出 现 的 配置 栏 (图 $.12 ) 中 
输入 **/target/site/cobertura/coverage.xml， 其 他 的 配置 
保留 默认 值 即 可 。 


图 5.12 ”Cobertura 覆盖 率 报表 统计 


构建 后 操作 





Publish Cobertura Coverage Report 
Cobertura xml report pattern 


This is a file name pattern that can be used to locate the cobertura xml report fles (for example with Maven2 use "*/target/site/cobertura/coverage.xml). The path is relative to the 
module root unless you amt oo Thad your SCM with multiple modules, in which case it is relative to the workspace root. Note that the module root is SCM-specific, and may not be 
the same as the wo 

obertura must be orienad wm generate XML reports for this plugin to function. 


Consider only stable builds ” 口 


Include onily stable builds, i.e. excliude unstable and failed ones. 
Fail builds if no reports 








fail builds if No coverage reports are found. 


这 样 Cobertura 的 配置 就 完成 了 。Jenkins 会 将 覆盖 率 的 报表 以 美观 、 
另 民 的 形式 呈现 出 来 (图 5.13 )。 
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图 5.13 ”Jenkins 的 覆盖 率 报表 

















ee 代码 . 覆盖 率 
过 克 更 i 录 Cobertura 覆盖 率 报表 


加 Console Output 时 间 顺 序 














加 Ea 
S Coverage Report 
er prints 

















竹 让 :次 构建 



















































76% 109/144 | 

















包 
| 100% ER 


方法 





59% 52/8Ba aa 















Jenkins 下 能 够 看 到 每 种 度量 方式 的 履 盖 率 变 化 的 图 表 ， 以 及 更 进 一 


步 的 每 个 class 文件 的 履 盖 这 。 开 始 统计 和 履 盖 率 后 ， 开 发 人 员 编 写 测试 
代码 的 积极 性 也 会 有 所 提高 。 看 痢 每 次 添加 测试 履 凑 率 都 会 有 所 提升 ， 


























这 是 一 件 很 有 成 束 感 的 事情 。 在 提高 团队 开发 的 质量 的 过 程 中 ,维持 开 
发 人 员 编 写 测试 代码 的 积极 性 是 相当 重要 的 要 素 ， 从 这 一 





覆盖 率 的 统计 也 是 相当 重要 的 。 


5.4.8 静态 分 析 














所， 认可 以 进步 提高 团队 开发 的 质量 。 因 此 应 通过 
查 代码 是 否 符合 编码 规则 、 是 否 容易 产生 bug 等 。 








能 够 在 Jenkins 中 使 用 的 静态 分 析 工 具有 以 下 这 些 。 


@ Checkstyle”™ 
e PMD” 
® Findbugs” 


(QD) http://checkstyle.sourceforge.net/ 
2 http://pmd.sourceforge.net/ 
3) http://findbugs.sourceforge.net/ 
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意义 上 来 说 对 


太 人 外 


在 上 自动 化 测试 和 统计 代码 覆盖 率 的 基础 上 ， 知 能 对 代码 实施 项 态 分 
Jenkins 持续 地 检 
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各 个 工具 都 有 目 己 的 特点 。Checkstyle 擅长 编码 规则 的 检查 等 ; 
PMD 的 可 定制 化 的 程度 高 ， 对 编码 规则 以 及 洪 在 的 bug 都 能 够 检查 ; 
Findbugs 则 以 善于 检查 潜在 的 bug 为 特点 。 各 个 工具 都 支持 规则 的 定制 
和 扩展 。 请 根据 项 目的 具体 情况 选择 合适 的 工具 。 

使 用 Maven 作为 build 工具 的 话 ， 琵 态 分 析 工 具 和 JUnit、Cobertura 
一 样 ， 安 装 Maven 的 插件 即 可 人 使用。 当然 在 Ant 等 上 面 也 可 以 使 用 。 
Jenkins 的 话 同 样 只 要 安装 插件 就 能 使 用 。 

通过 CI 实施 静态 分 析 的 优点 有 很 多 ， 其 中 最 显著 的 是 可 以 减轻 代 
人 码 review 时 的 负担 这 一 点 。 人 代码 review 虽说 是 为 了 提高 质量 而 需要 实 
施 的 实践 项 目 之 一 ,但 其 实施 的 成 本 之 高 是 无 法 忽视 的 。 而 如 果 能 确保 
静态 分 析 目 动 化 ，review 时 就 可 以 忽略 对 编码 规则 每 细 方 的 检查 ， 从 而 
对 更 为 本 质 的 内 容 进 行 review。 

面 问 Java 这 样 的 静态 类 型 语言 的 静态 分 析 工 具 还 是 比较 多 的 ,但 面 
问 动态 类 型 语言 的 工具 就 比较 少 了 。 特 别 是 要 通过 Jenkins 来 统计 的 话 
就 更 难 了 。 即 便 如 此 ， 还 是 有 面 回 JavaScript 的 J SLint 等 几 款 可 以 通过 
Jenkins 进行 统计 的 工具 ， 可 以 根据 需求 试 着 找 一 下 。 如 采 没 有 的 话 ， 目 
行 制作 也 不 失 为 一 个 不 错 的 方法 。 












































5.4.9 ”配置 通知 





seeeeeeseseeeeeeseeeeseeeeseeeseseeeseeeeeeseseeeeseeeeeeeseeeeeseeeeseeeeeeseeeeseeeeseeesseeeeeseeeeseeeseeeeeseeeeeeeeeeeseeeeeee 


最 后 对 build 结果 的 通知 进行 配置 。 包 括 捅 件 在 内 ，Jenkins 提供 了 
多 种 通知 build 结果 的 手段 。 可 以 通过 邮件 、IRC、Twitter 来 通知 ， 还 可 
以 利用 称 为 XFD ( eXtreme Feedback Device ) 的 硬件 进行 通知 。 特 别 是 
XFD， 经 过 精心 的 设计 ，XFD 在 build 失败 时 会 鸣 响 警报 或 发 射 玩 具 火 
和 前 等 ， 非 常 有 趣 。 

这 里 讲解 一 下 通过 邮件 来 通知 的 方式 。Jenkins 默认 提供 了 邮件 通知 
的 功能 ， 只 需要 在 “构建 后 操作 ”中 选择 “E-mail Notification” 即 可 
(图 5.14 )。 








(DD http:/www.jslint.cony 
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图 5.14 ”邮件 通知 的 设置 


构建 后 操作 





E-mail Notification 加 
Recipients dev-team@shanon.co,jp 
Whitespace-separated list of recipient a s. May reference build parameters like $PARAM. E-mail will be sent when a build fails, becomes unstable or returns to stable. 


加 条 次 不 御 的 构 只 种 发 送 如 件 通 和 
回 单独 发 送 邮 件 给 对 构建 造成 不 良 影响 的 责任 人 Oz 





在 收 件 人 Recipients ) 处 填写 邮箱 地 址 后 ， 在 build 失败 或 者 失败 
的 build 被 修复 时 就 会 收 到 邮件 通知 。 可 以 在 此 配置 团队 的 邮件 列表 等 。 
默认 设置 中 选中 了 “每 次 不 稳定 的 构建 都 发 送 邮 件 通 ek 这 样 一 来 ， 
在 连续 build 失败 的 情况 下 ， 每 次 都 会 收 到 通知 邮件 。 这 样 设 置 是 
没有 问题 的 ,但 如 有 果 项 目 经 党 build 失败 、 状 态 不 好 ， td 
不 会 每 次 失败 时 都 收 到 邮件 了 。 但 这 里 并 不 建议 解除 该 选项 。 

如 采 选 中 i i 展 影 响 的 责任 人 >”， 那 么 
除了 刚才 在 收 件 人 处 配置 的 邮箱 地 址 之 外 ， 还 会 给 造成 build 失败 的 当 
事 人 发 送 邮件 。 使 用 该 功能 需要 预先 为 Jenkins 配置 邮件 服务 器 
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5.5 CI 的 运用 
Jenkins 的 配置 完成 后 就 可 以 实施 CI 了 。 这 里 我 们 来 说 一 下 CI 运用 
上 的 小 先 门 以 及 同 版 本 管理 系统 和 缺陷 管理 系统 的 协作 。 


5.5.1 build 失败 了 该 怎么 办 


seeeeeeeeeeseeeseeeseeeseseeseeeseeseseeseeeeeeseeeseeeeseeeseeeseeeeseeseeeeseeeeeseeeseeeeeeeseeeseeee 





开始 实施 CI 后 会 由 于 某 人 的 提交 而 造成 build 出 错 。 这 里 所 说 的 
build 出 错 是 指 代码 无 法 编译 ( compile )、 静 态 分 析出 现 错误 、 测 试 失败 
等 现象 。 

那么 build 失败 的 话 应 该 怎么 办 呢 ? 造成 build 失败 的 当事人 应 该 对 
提交 进行 修改 ， 避 人 免 build 再 度 失败 。 而 其 他 的 团队 成 员 应 该 做 些 什 么 
呢 ? 这 个 根据 版 本 管理 系统 运用 方式 的 不 同 而 有 所 差异 。 








@.…… Subversion 等 中 央 集 权 型 版 本 管理 系统 的 情况 


build 失败 的 话 ， 从 那 一 刻 起 就 不 得 不 禁止 在 相同 代码 库 的 相同 分 文 
上 进行 开发 的 所 有 成 员 的 提交 。 对 于 全 员 都 在 同一 代码 库 上 进行 开发 的 
中 央 集 权 型 版 本 管理 系统 来 说 ， 在 造成 失败 的 提交 上 再 登 加 其 他 人 的 提 
交 的 话 ， 修 改 会 变 得 更 为 困难 。 最 糟糕 的 情况 是 在 造成 build 失败 的 提 
交 之 上 又 三 加 了 其 他 有 问题 的 提交 ， 这 样 的 事情 也 是 存在 的 。 














e…… Git 等 分 布 式 管理 系统 的 情况 


Git 的 情况 下 原则 上 和 Subversion 一 样 。 从 build 失败 的 那 一 刻 起 就 
要 禁止 在 相同 代码 库 的 相同 分 支 上 进行 开发 的 所 有 成 员 的 提交 ， 这 是 比 
较 简 便 的 运用 方法 。 采 用 第 3 章 中 介绍 的 git-flow 这 样 的 工作 流程 ， 全 
员 向 同一 个 代码 库 进 行 Push 的 话 ， 就 需要 禁止 提交 。 

但 是 像 github-flow 这 样 ， 各 个 成 员 拥 有 自己 的 代码 库 ， 通 过 发 送 
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Pull Request 进行 修改 的 话 ， 就 没有 必要 禁止 全 员 提 交 了 。 只 需要 在 Pull 
Request 被 发 送 到 中 央 代 码 库 时 确认 该 Pull Request 和 中 央 代 码 库 合并 后 
的 代码 是 否 能 够 通过 build 即 可 。 这 也 是 比较 可 行 的 方法 。 


-一 专栏 ”造成 build 失败 后 的 惩罚 游戏 

笔者 所 在 的 公司 中 ，build 失败 时 会 向 全 体 成 员 发 送 邮件 ， 并 且 
规定 从 收 到 邮件 后 到 build 恢复 正常 为 止 禁止 全 员 的 提交 。 

为 了 让 大 家 知道 是 谁 造 成 了 build 失败 ， 造 成 build 失败 的 人 要 
戴 一 项 大 的 礼服 帽 作 为 惩罚 游戏 。 直 到 build 修复 为 止 ， 要 一 直 戴 着 
这 项 帽子 ， 公 司 内 部 会 议 也 只 能 戴 着 帽子 参加 ( 图 5.c )。 因 为 这 样 非 
常 丢脸， 所 以 大 家 在 提交 时 会 加 倍 小 心 。 但 如 果 做 过 了 头 就 变 得 像 追 
查 犯人 一 样 ， 导 致 开发 人 员 畏 首 畏 尾 ， 不 愿意 从 事 具 有 挑战 性 的 新 功 
能 开发 。 因 此 要 保持 在 开玩笑 ”的 程度 ， 让 团队 开发 顺利 地 推进 。 





图 5.c 戴 大 礼服 幅 的 惩罚 游戏 




















QD 开玩笑 是 团队 开发 中 的 重要 元 素 。 它 能 够 促进 团队 成 员 之 间 的 交流 ， 使 项 目 顺 
利 进 展 。 可 以 采用 之 前 提 过 的 XFD， 或 者 使 用 Jenkins Emotional Plugin ( https:// 
wiki.jenkins-ci.org/display/JENKINS/Emotional+JenkinstPlugin ) 这 款 会 根据 build 
结果 改变 Jenkins 先生 的 表情 的 插件 ， 都 是 非常 有 趣 的 。 
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@…… 测试 后 合并 


本 草 在 介绍 TravisCI 时 介绍 过 ， 结 合 GitHub 和 TravisCI 能 够 实现 
测试 通过 后 再 提交 。 其 实 Jenkins 借助 GitHub pull request builder plugin 
插件 也 可 以 实现 同样 的 功能 。 这 款 择 件 可 以 实现 的 功能 和 TravisCI 基本 
相同 。 插 件 的 配置 方法 可 能 稍 许 有 些 复 休 ， 具 体 请 参考 插件 的 帮助 网 站 
(英文 )”。 这 里 只 做 简单 的 讲解 。 








@ 安装 插件 
采用 和 Git Plugin 相同 的 安装 方法 “安装 GitHub pull request builder 
plugin 插件 即 可 。 


@ 在 GitHub 上 新 建 bot 用 户 
插件 上 自身 为 了 在 Pull Request 中 添加 各 类 评论 ， 需 要 bot 用 户 。 在 
GitHub 上 以 适当 的 名 字 新 建 用 户 〈 可 以 使 用 和 目 己 喜欢 的 名 字 )。 


全 配置 Jenkins 的 系统 

输入 GitHub API 的 URL 以 及 GitHub 的 用 户 名 /密码 (图 5.15 )。 
除了 用 户 名 /密码 之 外 ， 也 可 以 输入 GitHub 的 Access Token (使 用 
Access Token 更 为 安全 )。 在 Admin list 中 填写 作为 该 插件 的 Admin 的 
GitHub 用 户 的 列表 。Admin 可 以 在 Pull Request 的 评论 上 通过 和 bot 用 
户 的 对 话 进 行 各 类 操作 。 其 他 的 项 上 日 保留 默认 值 即 可 。 








JJ https://wiki.jenkins-ci.org/display/JENKINS/GitHub+pull+request+buildert+plugin 
@ 请 参考 5.4 节 。 
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图 5.15 GitHub pull request builder plugin 的 配置 





Github pull requests builder 
Github server api URL https://api.github.com 
Username 
Password 


Use comments to report results when updating commit status fails 





Admin list 





Published Jenkins URL 


Request for testing phrase Can one of the admins verify this patch? 
Add to white list phrase .*+add\W+to\W+whitelist.* 

Accept to test phrase .*OkK\W+to\W+test.+* 

Test phrase .*test\W+this\W+please.* 

Crontab line */5 二 二 二 二 


Access Token 








@@ 配置 各 个 任务 

对 各 个 任务 进行 配置 。 首 先 ,在 GitHub project 中 填写 对 象 GitHub 
代码 库 的 URL。 代 码 管理 系统 的 配置 选择 Git， 设 置 为 Repositories 的 
Repository URL。 “高 级 ”的 refspec 栏 填 人 +refs/pull/*:refs/ 
remotes/origin/pr/*。Branches to build 的 Branch Specifier 设置 为 
$f{shal}。 接 着 ， 在 “构建 触发 需 ” 中 的 GitHub pull requests builder 这 
个 选项 上 打 钩 。 在 Admin list 中 添加 这 个 任务 中 作为 Admin 的 用 户 信 
息 。 如 果 事 先知 道 发 送 Pull Request 的 用 户 的 话 ， 可 以 在 “高 级 ”的 
White list ( 日 名 单 ) 中 输入 该 用 户 的 名 称 ， 这 样 配置 能 够 简便 很 多 。 








四 实际 发 送 Pull Request 

试 着 发 送 Pull Request。 对 于 收 到 的 Pull Request， 中 央 代 码 库 会 每 
隔 5 分 钟 实 行 一 次 目 动 build，build 结果 将 可 视 化 地 显示 在 GitHub 中 
(图 5.16)。 
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图 5.16 ”Pull Request 的 build 结果 





[EE buster84 wants to merge 1 commit into shanon:master from bustera4:odd_demo_confi.. 181 加 本 本 可 本 。。 才 25 


咖 Discussion ， Commits 1 国 Files Changed 1 


buster84 opened this pull request 9 minutes ago Edit | open | 


Added CS expo configuration 


+181 additions 
No one is assigned ©@ - No milestone 名 - -0 deletions 
@benzookapi @shot056 @ishiyamachiaki 

添加 了 CS expo 的 配置 文件 。 

请 review。 























® Determining merge status 一 Merged build started. (Details) 
2 participants 起 


Or buster84 added a commit 27 minutes ago 


buster84 Added CS expo configuration X c2ccdca 











可 以 确认 Pull Request 的 内 容 说 明 下 方 有 “Determining merge status 
-- Merged build started.(Details)” 这 样 的 信息 。 这 是 为 了 判断 是 否 能 够 合 
并 而 开始 执行 build 时 输出 的 消息 ”。 点 击 Details， 会 迁移 到 相关 的 
Jenkins 男 面 ( 医 5.17 )。 


图 5.17 在 Jenkins 中 确认 Pull Request 的 build 结果 





Jenkins ) DeeElle ) #17 人 允许 自动 刷新 



































会 返回 到 工程 15 分 前 亿 开 始 


-we @ 构建 #17 (2013/04/25 18:51:29) FR 1 42 1 on savel 


也 交 更 记录 








Pull request #25 
[| Console Output 谓 说 明太 变更 


于 编辑 编译 信息 





@ | 除 本 次 和 成 No changes. 
删除 本 次 
， 构建 参数 | | 
一 全 Github pull request #25 of commit c2ccdca2aa6df7db37aa301fbbf6302c50edbadc automatically merged. 
二 Git Build Data 
加 "EE Revision: 67aa346b9c56209814ed6d23156e27d5063a7286 
© Tags 


e origin/pr/25/merge 
回 ] 测试 结 果 


你 前 一 次 构建 











测试 结果 ( 7 个 失败 /+7 ) 
models.process.JobManagerSpec.JobManager should::not allow to start a job if another job is not working 
but last job's starting time is in span time 


models.process.JobManagerSpec.JobManager should::allow to start a job when it is first time to start job 





WA 


models.process.JobManagerSpec.JobManager should::allow to start a job also like this 
models.process.JobManagerSpec.JobManager should::allow to start a iob if another job is not working and 
last iob's starting time is not in span time 

models.process.JobManagerSpec.JobManager should::allow to start a job also like this 
models.process.JobManagerSpec.JobManager should::allow to start a job if another job is already started 
but the job name is different 

models.process.JobManagerSpec.JobManager should::not allow to start a ijob if another job is workin 

















轧 Help us localize this page 更 新 : 2013/04/25 19:07:06 REST API Jenkins ver. 1.489 








QD 这 时 如 果 build 已 经 成 功 ， 就 会 出 现 “Good to merge”; 反之 如 果 失 败 的 话 ， 则 会 
出 现 “Failed” 这 样 的 消息 。 
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从 图 5.17 中 可 以 看 出 ，25 号 的 Pull Request 造成 了 7 个 测试 失败 。 
也 就 是 说 ， 这 个 Pull Request 不 能 合并 到 中 央 代 人 码 库 。 

这 样 的 运用 方法 能 够 防止 将 造成 build 失败 的 提交 合并 到 中 央 代 码 
库 。 因 此 能 够 避免 由 于 某 人 的 提交 有 问题 而 造成 全 员 作 业 俘 止 这 样 的 





@ 添加 White list 或 重新 执行 build 

提交 Pull Request 的 用 户 如 果 还 没有 被 添加 到 Admin list 或 White 
list 的 话 ，build 则 不 会 被 执行 。 这 时 bot 用 户 会 在 Pull Request 中 添加 
“Can one of the admins verify this patch ?” 这 样 的 评论 。 对 此 ，Admin 将 
下 列 两 个 回答 之 中 的 任意 一 个 作为 评论 添加 在 Pull Request 中 ， 即 可 通 
过 bot 用 户 指 示 插 件 开始 执行 build。 

ok to test 
实施 build。 


add to whitelist 
将 建立 Pull Request 的 用 户 添 加 到 White list 并 实施 build。 这 样 ， 从 
下 次 开始 ， 由 该 用 户 建 立 的 Pull Request 就 会 被 自动 build。 想 要 再 次 执 
行 已 经 执行 过 的 build 时 ， 只 需 添 加 下 列 评论 即 可 "。 
Gasese 
如 果 觉 得 上 述 过 程 麻烦 的 话 ， 上 只 要 在 最 初 的 任务 配置 阶段 将 用 户 添 
加 到 White list 中 即 可 。 另 外 ， 正 如 $.4 节 的 第 一 个 专栏 中 所 提 到 的 那 
样 ， 要 想 使 用 该 插件 ， 就 需要 支持 GitHub 回 Jenkins 发 送 请 求 的 网 络 结 
构 。 添 加 只 允许 GitHub 的 IP 地 址 发 出 请 求 的 IP 过 小 规则 ， 这 样 安全 性 
方面 就 不 用 担心 了 。 即 使 不 使 用 GitHub， 也 可 以 采用 相同 思路 的 运用 策 
略 。Jenkins 的 作者 川口 耕 介 将 这 样 的 思路 称 为 “验证 后 合并 ”“。 只 向 主 
分 文 合 并 经 过 验证 的 、 没 有 问题 的 修改 ， 由 此 来 避免 因 某 人 提交 造成 
build 失败 ， 进 而 导致 全 体 人 员 作业 停止 的 事态 ， 团 队 开 发 的 生产 效率 也 
能 更 上 一 层 楼 。 
这 些 命令 语句 自身 都 可 以 在 图 5.15 的 配置 中 修改 。 
事实 上 Subversion 也 支持 验证 后 合并 的 运用 方式 。 
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5.5.2 ”确保 可 追溯 性 


build 失败 或 发 生 问 题 时 ， 有 问题 的 build 是 哪 次 提交 产生 的 ， 该 提 
交 原 本 是 为 了 解决 怎样 的 问题 等 ， 如 果 能 够 追溯 上 述 信息 ， 那 么 对 于 实 
际 的 运用 是 很 有 帮助 的 。 

通过 Jenkins 和 缺陷 管理 系统 以 及 版 本 管理 系统 的 协作 ， 能 够 确保 
各 类 信息 的 可 追溯 性 ， 实 现 项 目的 可 视 化 (图 5.18 )。 


图 5.18 ”确保 可 追溯 性 















staging 环境 


缺陷 管理 
系统 

统计 提交 、 
测试 、 部 团 
(的 状况 




















@…… 关联 build 和 提交 


阅读 到 这 里 并 实施 了 CI 的 话 ，Jenkins 和 版 本 管理 系统 的 关联 应 该 
已 经 配置 完成 了 ”, 当然 不 配置 的 话 也 无 法 实施 CI。 也 就 是 说 , 只 要 通过 
Jenkins 实施 CI， 就 能 将 build 和 提交 明确 地 关联 起 来 。 大 致 的 印象 如 图 
5.19 所 示 。 











@ 请 参考 5.4.4 节 的 内 容 。 
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图 5.19 用 Jenkins 关联 build 和 提交 















































Jenkins |) DeeElle 人 允许 自动 刷新 
返回 到 工程 1 1 
全 侈 改 记 录 
各 状态 集 
~ i #23 (2013/04/26 18:41:35) 
名 变更 记录 
[0 Console D 1. Fix tests (commit: eSQe! 68a SEA 57b38beb377alcc4cfb4efe) 一 okum Yy/githubweb 
TT 2. Added CS expo configuration (commit: c2ccdca2aa6df7db37aa301fbbf6302c Se dbad c) 一 okyu a.y / github 
多 编辑 编译 信息 3. Change playhe pe version and log level (commit: 0a6ac26ca7147706eb3114baaf3a Ee ed okumura a ubweb 
:机 删除 本 次 生成 #14 (2013/04/24 19:21:41) 
~ 1. Add job scheduler (commit: 37ccia0iSc48ce2e20574f6b0a0b19d9f811e36b) 一 okumura.y / githubweb 
2. Added comments and delete some unused test codes. (commit: b40c672d86bdO0fec84e701cfc1c9097554517123) 一 okumura.y / githubweb 
站 = GitHub Hook Log #9 (2013/04/18 19:41:4 
自 Git Polling Log 1. add alldownlo 这 ontroller (commit: 3ac38476e20c361518a723a7b77a2e56a37c6377) 一 okumura /ith ubweb 
2. Add develol SS configuration (commit: 3ea95a ee 1041c2b2785a6453667a5ce612) 一 okumura.y / githubweb 
| » Build History ( 时 间 顺 序 ) 到 Fix bugs whi i occured in downloading userlist and contents ra g (commit: 4c a aa213c6b0c a de525bf83b22f) — okumura.y / githubweb 
| 4. typo (commit: 8a143449e a 34e3294f6d3542f717e a a okumura.y / gith 








@ #23 2013/04/26 18:41:35 5. Change tmp directory to be configurable and change steps of deleting tmp files (co er 7605140342aal04647fdc0c30c45bcfa6da689b9) 一 okumura.y / githubweb 
© #22 2013/04/26 18:21:36 #5 (2013 /04 /15 16:11:48) 

© #21 2013/04/26 10:31:29 

© #20 2013/04/25 20:35:22 

@ #19 2013/04/25 20:33:04 

@ #18 2013/04/25 20:31:20 


@ #17 2013/04/25 18:51:29 
由 Uest #25 





1. Added installation steps (commit: 7b675b3ea71dd21143a8d7d3100022750e829307) 一 okumura.y / githubweb 

















如 图 5.19 所 示 ， 在 Jenkins 的 build 号 、Git 的 提交 编号 以 及 提交 者 
这 些 信息 之 间 建 立 起 了 关联 。 例 如 ， 可 以 看 出 雪 3build 和 3 个 提交 有 
关 。 男 外 ， 从 图 5.19 中 还 可 以 看 到 有 代码 库 浏览 器 (本 例 为 GitHub ) 
的 链接 ， 可 见 build 和 代码 的 Di (差分 ) 之 间 的 关联 也 建立 起 来 了 。 
这 样 ， 即 使 build 失败 ， 也 能 够 顺 蕨 摸 瓜 地 弄 清 是 谁 造 成 的 、 修 改 
的 内 容 是 什么 。 这 一 功能 在 应 对 问题 等 时 候 是 非常 有 用 的 。 


@.……… 关联 缺陷 管理 


如 果 Jenkins 已 经 和 缺陷 管理 以 及 版 本 管理 进行 了 关联 的 话 ，build 
和 提交 ， 以 及 提交 和 相关 问题 票 号 之 则 就 都 建立 起 了 相应 的 联系 。 

这 次 以 nulab 公司 的 Backlog 产品 为 例 进 行 说 明 。 如 同 在 第 4 草 提 
到 的 ，Backlog 是 集 缺 陷 管 理 系统 和 版 本 管理 的 代码 库 浏 览 锅 于 一 体 的 
SaaS 系统 。 想 要 关联 Jenkins 和 Backlog 的 话 ， 首 先 需要 安装 Backlog 
插件 。 和 Git 插件 一 样 ， 请 从 管理 插件 处 进行 安装 。 安 装 后 打开 各 任务 
的 配置 画面 ， 会 出 现 如 下 输入 框 ， 请 输入 Backlog 工程 的 URL、 用 户 
ID 2 User ID ) 和 密码 ( Password )( 图 5.20 )。 同 时 在 Backlog 中 也 需要 

行 配 置 ， 将 版 本 管理 系统 的 提交 记录 和 问题 票 天 联 起 来 。 
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图 5.20 ”Jenkins 和 Backlog 的 关联 











回 Backlog 

Backlog URL | https://shanonpj.backlog.jp/projects/SSAPI 加 
User ID | ikeda tt @ 
Password | wooeseee 图 














Backlog 能 够 和 Subversion 以 及 Git 这 两 个 版 本 管理 系统 进行 协作 。 
结合 使 用 Backlog 和 Subversion 的 情况 下 ， 要 选中 图 5.21 中 的 “提交 信 
县 连接 诛 题 ”选项 。 


图 5.21 ”Backlog 和 Subversion 的 关联 














项 目 设 置 
编辑 项 目 ( 假如 您 不 是 此 项 目 成 员 ， 某 些 功 能 链接 将 失效 。 ) 
项 目 设置 . 回 
目的 基本 设置 Subversion 设 置 
成 员 
主题 此 项 目 不 使 用 Subversion 
Subversion" 标签 将 不 显示 于 各 页 面 。 
种 类 
类 别 @ 在 贝 格 乐 建 立 存储 库 (Repository) 
此 链接 【https://ysylife.backiogtool.com/svn/TRANS_TEAMWORK/】 是 Subversion repository。 
ee | 回 提交 信息 连接 课题 
提交 信息 将 作为 相关 课题 的 新 评论 ， 若 信息 中 含有 某 些 关键 字 (如 : #closes,#ixes 等 ) ， 课 题 的 状态 将 自动 更 新 。 
Subversion 
Git 使 用 外 部 Repository (Premium 或 以 上 方案 ) 


Git 的 话 如 图 5.22 所 示 。 


图 5.22 Backlog 和 Git 的 关联 


项 目 设 置 
编辑 项 目 (* 假如 您 不 是 此 项 目 成 员 ， 某 些 功能 链接 将 失效 。 ) 








项 目 设置 


编辑 项 目的 基本 设置 Git 设 置 — 





成 员 Repositories | | 设置 








主题 
种 类 | 回 连接 课题 和 关键 字 
类 别 提交 信息 将 作为 相关 课题 的 新 评论 ， 若 含有 某 些 关键 字 (如 : #closes,#fixes 等 ) ， 课 题 的 状态 将 自动 更 新 。 


版 本 / 
里 程 碑 





Subversion 








Git 





这 次 使 用 了 Subversion 作为 版 本 管理 系统 。 至 此 配置 就 完成 了 。 在 
这 种 状态 下 ， 将 问题 标号 添加 到 提交 记录 中 提交 并 执行 build，Jenkins 
上 就 会 生成 如 图 5.23 这 样 的 修改 记录 画面 。 
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图 5.23 在 Jenkins 上 和 Backlog 的 Subversion 进行 关联 
























































ni AplCOrinon i Trunk i 时 介 许 动 局 新 
返回 到 工程 

a 修改 记录 

GOA 状态 集 

名 变更 记录 #296 (2013/05/22 20:11:32) 

® Console Output 298. 到 场 统计 AP| 的 GET 方法 的 实现 一 suzuki / Backlog 

从 ) 编辑 编译 信息 #288 (2013/05/17 12:38:38) 

© 删除 本 次 生成 297. 在 mailsender.get 中 添加 取得 post 方法 预约 发 信 时 间 和 时 和 分 一 suzuki / Backlog 
ba 设 定 #2 2013/05/16 22:40:27 

一 ES 296. 消息 内 容 和 测试 数据 的 修正 一 suzuki / Backlog 

二 Backlog 


#284 (2013/05/16 21:11:32) 


295. 取得 compaign 项 目 配 置信 息 的 APV 取得 sub campaign 项 目 配置 信息 的 APV 取得 演讲 者 项 目 配置 信息 的 APl-suzuki /Backlog 


#280 (2013/05/16 15:51:33) 





自 Subversion Polling Lo 























加 Coverage report 


| Build History ( 时 间 顺 序 ) | 








< 

@ #309 2013/05/29 11:29:58 294. 将 SsApiCommon 版 本 更 新 至 0.16 一 suzuki/ Backlog 
/ J 2 H 

@ #308 2013/05/29 10:18:43 #279 (2013/05/16 15:11:33) 

@ #307 2013/05/28 12:37:41 293. 添加 文件 信息 API 的 get、post 方法 一 suzuki/ Backlog 


了 #306 2013/05/28 11:25:41 

#305 2013/05/28 10:18:55 

#304 2013/05/27 11:25:47 292. 实现 批量 发 送 邮 件 API 的 get、post 和 getall 方法 一 suzuki / Backlog 

A #273 (2013/05/14 20:49:48 

息 #302 2013/05/27 10:04:22 
#301 2013/05/26 10:18:55 


#275 (2013/05/15 13:11:3 


OE 





291. 添加 mailtemplate 的 get、post 和 put 方法 一 suzuki/ Backlog 





了 #300 2013/05/25 10:18:56 #267 (2013/05/10 13:41:33) 
. /05/ :28: i es 
© #299 2013/05/24 11:28:11 290. 对 peach 环境 应 用 bug21545 的 修改 内 容 ， 因 此 要 修改 按 环境 来 区 分 测试 的 部 分 一 suzuki/ Backlog 









































点 击 Backlog 的 链接 ， 迁 移 到 如 图 5.24 所 示 的 代码 库 浏 览 希 。 这 里 
到 Diff 舍 信 息 /CA O 


图 5.24 ”Backlog 的 代码 库 浏览 器 
| 修改 P31 大 | 














<< 上 一 个 修改 (r230 ) 下 一 个 修改 ( r232 ) >> 





修改 概要 








更 新 时 间 2011/12/15 18:18 
更 新 者 on | 【 shanon 】 池 田 尚 史 有 H 
ve SSAPIE2 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 
#fixed 















































Commit 会 影响 路 径 名 字 











: SsApiCommon/jtrunk/src/main/java/jp/co/shanon/ss/api/services/Activity.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 














古 


: SsApiCommonjtrunk/src/main/java/jp/co/shanon/ss/api/services/Application.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 





















































: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/Session.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 # ] 





















































: SsApiCommonjtrunk/src/main/java/jp/co/shanon/ss/api/services/Visitor.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 


























: SsApiCommonjtrunk/src/main/java/jp/co/shanon/ss/api/services/VisitorApplication.java |[ 显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 




















: SsApiCommon/trunk/src/main/java/jp/co/shanon/ss/api/services/VisitorFile.java [显示 差异 | 历史 纪录 | 用 浏览 器 直接 打开 ] 


从 代码 库 浏 览 器 上 可 以 确认 问题 票 号 及 其 链接 。 图 5.24 中 的 
“SSAPI-21” 部 分 就 是 问题 票 的 链接 ， 点 击 链接 就 能 前 往 如 图 5.25 所 示 
的 对 应 的 题 票 。 
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图 5.25 ”能 够 链接 到 对 应 的 问题 票 





SSAPI-21 入 | 提交 日 期 : 2011/12/15 15:10:28 | 开始 日 : 2011/12/15 | 期限 日 : 2011/12/15 


给 SsApiCommon 添加 重新 取得 Token 的 功能 


Task 优先 级 ”中 
结束 理由 
状态 ”结束 
里 程 碑 责任 者 ”【 shanon 】 池 田 尚 史 
预计 使 用 时 间 实际 使 用 时 间 


详细 om 【 shanon 】 池 田 尚 史 SF 





只 显示 注释 ( 3 ) 





























2011/12/15 18:18 [ shanon ] 池田 尚 史 s 有 
0 状态 : 未 处 理 -> 处 理 完毕 
0 提交 :rz231 
SSAPI-21 


添加 了 GET、PUT、DELETE、 各 自重 新 取得 Token 的 功能 








像 这 样 ，Jenkins 提供 了 和 Backlog 等 各 种 缺陷 管理 系统 进行 协作 的 
插件 。 这 次 以 Saag 形式 提供 的 、 便 利 的 Backlog 为 例 进行 了 说 明 。Trac 
和 Redmine 也 提供 了 Jenkins 的 插件 ， 可 以 实现 完全 相同 的 配置 。 请 以 
实现 高 可 追溯 性 的 CI 为 目标 ， 有 效 地 加 以 运用 。 
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5 6 ， 本章 总 结 
借助 CI 能 够 实现 的 事情 


本 和 草 介 绍 了 CI 的 实践 ， 并 对 实现 CI 所 必需 的 编译 工具 、 测 试 框 
架 、CI 工 具 进 行 了 说 明 。 通 过 导入 CI， 能 够 时 稼 实施 编 主 和 测试 ， 这 
样 就 能 既 迅 速 又 准确 地 获得 开发 内 容 的 反馈 ， 在 保持 应 用 程序 高 质量 的 
同时 ， 还 有 助 于 提高 开发 速度 。 

只 外， 通过 在 CI 服务 器 上 对 各 类 信息 进行 统一 的 管理 ， 就 既 能 确 
保 可 追 溯 性 ， 又 能 够 推进 项 目的 可 视 化 。 依 助 CI 还 可 以 构筑 和 代码 库 
完全 对 应 的 、 能 够 时 常 保持 完全 运行 状态 的 应 用 程序 环境 ， 比 起 临近 发 
布 时 才 开 始 提心吊胆 地 耗费 长 时 间 进 行 编 详 ， 这 是 很 大 的 进步 。 

那么 ,在 CI 之 后 还 有 什么 呢 ? 借助 CI 我 们 已 经 确保 了 代码 库 中 应 
用 程序 能 够 一 直 正 党 运行 。 而 如 果 能 将 代码 库 中 的 程序 直接 发 布 到 正式 
环境 ， 那 么 应 对 市 场 变化 的 速度 不 就 能 大 大 提升 了 吗 ? 

实现 上 述 想 法 的 实践 就 是 持续 交付 ( CD，Continuous Delivery )。 第 
6 草 将 介绍 实现 CD 所 必须 要 做 的 事情 以 及 运用 上 的 一 些小 技巧 。 
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部 署 的 目 动 化 ( 持续 交付 ) 





6.1 ”应 该 如 何 部 署 。 ”200 

6.2 部署 的 目 动 化 。 202 

6.3 引导 (Bootstrapping ) 206 
6.4 配置 (Configuration ) 2 也 
6.3 编 配 (Orchestration ) 230 
6.6 考虑 运用 相关 的 问题 。 247 
6.7 本 章 总 结 255 
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6.1 应 该 如 何 部 署 





用 一 句 话 来 概括 这 一 章 就 是 “所 有 部 署 相 关 的 作业 都 应 该 实现 自动 
化 ”。 这 里 所 说 的 部 署 是 指 将 开发 的 代码 以 能 够 使 用 的 状态 放置 到 服务 
伪 上 这 一 连 串 行为 。 把 WAR 文件 上 传 到 Tomcat 等 容 需 上 的 行为 也 可 称 
为 部 署 ,但 这 个 是 更 为 广义 上 的 部 署 。 本 章 和 《持续 交付 》" 在 内 容 上 虽 
然 有 重复 的 部 分 ， 但 本 书 更 为 简明 易 懂 ， 笔 者 将 根据 自身 过 去 数 百 次 的 
部 署 经 验 ， 对 部 署 的 自动 化 进行 简单 的 说 明 。 重 点 对 部 署 的 最 优 方法 以 
及 简化 部 署 的 工具 的 使 用 方法 进行 讲解 。 




















6.1.1 部 署 自动 化 市 来 的 好 处 


实现 部 署 的 目 动 化 会 市 来 哪些 改善 ? 首 允 我 们 来 说 一 下 有 目 动 化 部 署 
的 优点 。 


eeeeeeeeeeeseeseeseeeeseeseeeeseeeseeeeseseeseeseeseeseeeeeeseeseeeeeeeeseee 











e…… 细 粒 度 、 频 繁 地 发 布 可 以 使 风险 可 控 


训 团 工作 本 号 就 不 是 一 件 轻松 的 事情 ， 如 果 几 个 月 才能 实施 一 次 音 
署 的 话 ， 程 序 就 会 有 多 个 部 分 产生 大 量 的 代码 修改 。 所 有 的 修改 都 能 
党 运行 日 然 最 好 ， 但 现实 往往 并 非 如 此 。 考 虑 到 多 个 较 大 的 故障 同时 发 
生 所 造成 的 严重 后 采 ， 这 的 确 是 个 玉手 的 问题 。 而 如 有 实现 部 普 的 目 动 
化 和 简易 化 ， 就 能 够 频繁 地 实施 部 署 ， 由 此 对 故障 规模 进行 控制 就 成 为 
了 可 能 。 








e…… 能 尽快 地 获得 用 户 的 反馈 
部 署 得 越 蛙 ， 就 能 获得 越 多 的 用 户 反 锯 。 尽 快 让 用 户 体 验 新 开发 的 


JW 《持续 交付 : 发 布 可 靠 软 件 的 系统 方法 》David Farley、Jez Humble 著 ， 乔 梁 译 ， 人 
民 邮 电 出 版 社 ，2011 
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功能 ， 并 将 用 户 的 反馈 反映 到 下 一 阶段 的 开发 中 ， 夺 能 形成 这 样 的 展 性 
循环 ， 就 能 确立 市 场 的 优势 地 位 。 通 过 频 演 地 进行 部 和 著 来 回收 开发 的 投 
资 ， 才 可 能 产生 收益 。 

但 上 述 情况 的 前 提 条 件 是 : 必须 要 有 接受 用 户 的 反馈 并 反映 到 开发 
中 的 流程 。 具 体 来 说 包括 分 析 用 户 的 评论 、 意 见 以 及 系统 的 日 志 等 ， 本 
曹 对 此 不 做 讲解 。 








@…… 团队 的 规模 可 控 


如 有 末 有 10 个 产品 ， 采 用 10 种 不 同 的 方法 手动 实施 部 半 的 话 会 怎么 
样 ? 每 个 产品 每 月 至 少 会 有 1 次 部 车 的 工作 ， 那 么 负责 部 署 的 运 维 团 队 
就 需要 专门 的 人 员 来 实施 部 署 。 如 末 运 维 团 队 的 人 手 不 足 ， 就 可 能 发 生 
新 产品 无 法 部 署 的 事态 。 而 如 有 果实 现 了 目 动 化 部 车， 就 不 必 担 心 运 维 团 
队 的 人 手 不 足 ， 这 样 束 能 够 推出 新 产品 并 获得 用 户 反 馈 。 借 助 部 署 目 动 
化 ， 团 队 人 数 的 规模 变 得 可 控 ， 因 此 可 以 放心 地 增加 产品 数量 。 
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6.2 部署 的 自动 化 


要 推进 部 署 的 日 动 化 ， 就 要 解决 这 样 一 个 问题 ， 最初 应 该 由 谁 着 手 
实施 ” 如何 实 施 ?” 其 实 答 案 就 是 “由 想 实施 部 署 目 动 化 的 人 春 于 去 做 台 
行 了 了 。 虽 然 有 些 简 单 粗 又 ， 但 这 是 最 合理 的 解答 。 如 宁可 能 的 话 ， 最 
好 以 对 服务 可 及 网 络 相 关 事 情 有 决定 权 的 运 维 团队 人 员 作 为 核心 成 员 。 
因为 不 可 避免 地 要 预 完 做 好 环境 相关 的 准备 及 调整 ， 以 及 最 终 疝 正式 环 
境 实 施 日 动 化 部 获 所 和 需 的 准备 工作 。 因 此 由 运 维 团队 的 人 员 来 牵头 着 手 
部 署 日 动 化 ， 项 目的 进展 会 比较 顺利 。 


























6.2.1 部 署 自动 化 方面 的 共识 


文 择 部 和 车 目 动 化 的 技术 方面 ， 要 选用 开发 人 员 ( Dev ) 和 运 维 人 员 
( Ops ) 都 能 够 使 用 的 技术 。 关 于 这 一 点 ， 在 充分 协商 的 基础 上 ， 双 方 
达成 一 致 是 非常 重要 的 。 缺 少 任何 一 方 的 协助 ， 都 无 法 顺利 实现 部 著 
的 目 动 化 。 因 为 部 署 是 指 从 开发 到 向 正式 环境 发 布 应 用 程序 为 止 的 一 
连 串 行为 。 

要 实现 部 署 的 目 动 化 ， 需 要 全 体 团 队 成 员 就 下 面 列 举 的 4 个 项 目 达 
成 统一 认识 。 


eeeeeeeeeeeseeeseeseeeeseeeeeeseeseseeeeeseseeseeseeseeseeeeeeseeseeeeeeeeseee 








@ 要 全 部 采用 版 本 管理 

@@ 所 有 的 环境 都 要 用 同样 的 方式 来 构建 

全 要 实现 发 布 工作 的 自动 化 ， 并 事先 进行 验证 
@@ 要 反复 多 次 进行 测试 














@ 的 话 请 参考 第 3 章 的 版 本 管理 系统 。 不 仅仅 是 应 用 程序 的 代码 ， 
目 动 化 相关 的 工具 、 数 据 库 、 测 试用 的 数据 等 都 应 该 作为 版 本 管理 的 对 
象 。 这 么 做 是 为 了 在 任何 时 候 都 能 够 恢复 到 过 去 的 任意 状态 。 
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关于 人 @ 和 合 ， 我 们 要 意识 到 应 该 采用 相同 的 方法 来 构筑 开发 环境 、 
测试 环境 、 正 式 环境 并 实施 发 布 。 这 是 在 推进 使 用 工具 进行 环境 构建 的 
过 程 中 必须 努力 做 到 的 要 点 之 一 。 即 便 是 手动 修改 了 1 行 配置 ， 那么 从 
这 一 刻 起 这 个 环境 中 就 混入 了 只 有 实施 修改 者 才 知 道 的 信息 。 

@ 是 指 对 目 动 化 部 署 实施 持续 的 验证 ， 大 量 收 集 其 成 功 和 失败 的 信 
上 县。 只 有 这 样 ， 回 正式 环境 实施 部 闭 工 作 的 准确 性 才能 得 到 你 证 。 如 采 
能 够 做 到 上 述 全 部 内 容 ， 那 么 部 著 将 不 再 是 可 怕 的 事情 。 














6.2.2 ”部 署 流水 线 


eeeeeeeeeeseeseeseeseseeeseseeseeseeeeseeeeseeeeeeeseeseeseseeeseseeeseeeseeeseseeeeseseseeeeseeseeseeseeeseeseeeeeseeeseeseeseeseeeeeseeeseeee 


实现 应 用 程序 的 build、 部 署 、 测 试 、 发 布 这 一 系列 流程 的 自动 化 称 
为 部 署 流水 线 ( deployment pipeline ) ”( 图 6.1 )。 








图 6.1 部 署 流水 线 


商业 提案 
RY 













正式 
环境 的 
构建 


| | Capisrano 
erverspec | Fablic 


| Kickstart ] RLogin/Tera 者 
| Term Pro 





| Vargant 


AWS 





部 署 流 水 线 











@ 详细 内 容 请 参考 之 前 提 到 的 《持续 交付 》 
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e…… 通过 自动 化 加 快 部 署 速度 


我 们 的 目标 是 构建 这 样 的 部 署 流水 线 ， 并 通过 流水 线 的 循环 尽量 加 
快 部 署 的 速度 ， 同 时 还 必须 确保 正确 性 。 能 够 想到 的 最 差 情况 就 是 : 从 
着 手 开发 到 发 布 经 历 了 数 月 一 数 年 之 入， 并 且 全 部 采用 手工 作业 ， 还 出 
了 差错 。 因 此 ， 在 部 署 流水 线 的 每 一 个 阶段 都 需要 全 体 团 队 成 员 就 之 前 
提 到 的 部 署 自动 化 中 的 4 个 项 目 达成 统一 认识 。 

部 署 流水 线 的 每 个 阶段 都 有 着 各 种 可 以 使 用 的 工具 。 将 各 个 阶段 的 
工具 组 合 起 来 就 有 可 能 加 快 部 署 的 速度 。 

例如 ， 提 交 某 个 bug 的 修改 ， 由 提交 引发 持续 集成 的 运行 ， 顺 利通 
过 build 后 自动 部 车 到 测试 环境 ， 执行 用 户 验 收 测 试 ， 通 过 测试 的 话 问 
正式 环境 实施 部 署 ， 在 正式 环境 上 实施 完 冒 烟 测试 “后 向 相关 人 员 发 送 
通知 。 到 此 为 止 的 所 有 流程 全 部 以 自动 化 的 形式 实施 。 上 述 流程 虽说 是 
比较 极端 的 例子 ， 但 确实 是 一 种 理想 形式 。 


























e…… 任何 人 都 能 够 实施 部 署 是 很 重要 的 


实际 上 一 般 的 流程 是 当 提 交 积 罕 到 一 定数 量 时 建立 分 支 ， 并 向 正式 
环境 实施 部 署 。 这 里 的 重点 是 部 普 流 水 线 要 能 够 顺畅 地 运转 起 来 ， 在 部 
署 的 各 个 阶段 都 不 允许 有 因为 对 人 的 依赖 而 无 法 部 署 的 情况 。 理 想 的 情 
况 是 任何 人 都 可 以 实施 测试 ， 也 都 可 以 实施 发 布 。 

当然 考虑 到 访问 权限 和 审批 流程 的 问题 ， 最 后 按 下 发 布 按键 的 可 能 
是 特定 的 人 ,但 并 不 是 说 这 和 需要 什么 特别 的 技术 。 换 而 言 之 就 是 : 不 需 
要 “发 布 技师 ”这 样 的 人 。 








6.2.3 ”服务 提供 工具 链 ( provisioning tool chain ) 


再 稍微 详细 地 对 图 6.1 中 给 出 的 工具 链 进行 一 下 说 明 。 大 致 可 以 分 
为 以 下 3 个 层次 来 考虑 ( 图 6.2 )。 





e@ 引导 ( Bootstrapping ) … 服务 器 OS 的 配置 及 基于 虚拟 机 的 服务 


中 修改 代码 进行 build 时 ， 为 了 确认 build 是 否 正常 结束 而 进行 的 测试 。 
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器 安装 自动 化 的 相关 工具 

@ 配置 ( Configuration ) … 服务 器 及 中 间 件 的 配置 自动 化 工具 

@ 业务 流程 ( Orchestration ) ... 代码 部 署 及 发 布 相关 的 服务 器 操作 
等 自动 化 工具 


以 上 3 个 层次 都 无 法 只 借助 1 个 工具 完成 所 有 处 理 ， 只 有 集 齐 各 个 
层次 的 工具 并 实现 流水 作业 ， 部 署 流水 线 才 能 够 完成 。 
接着 我 们 来 介绍 几 款 在 各 层次 中 出 现 的 工具 。 


图 6.2 服务 提供 工具 链 

















pe Bi 
服务 提供 工具 链 
Orchestration 应 用 程序 服务 的 部 署 自动 化 
Puppet 
Configration 系统 配置 Boxen 
| Chef 
Vagrant 
ee Kickstart 
Bootstrapping ns, OS 的 安装 AWS EC2 
> Cobbler 
VMware 
NU J 
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6.3 引导 ( Bootstrapping ) 


引导 层 局 动 服 务 角 的 OS， 使 服务 套 达 到 我 们 所 需要 的 状态 。 这 个 
层次 包括 了 OS 的 种 类 、 磁 盘 容 量 以 及 网 络 配 置 等 。 本 市 我 们 将 介绍 利 
用 服务 希 目 动 化 安装 以 及 虚拟 化 技术 来 构建 环境 的 目 动 化 工具 。 





6.3.1 Kickstart 


eeeeeeeeeseeeeeeeseeeeseeseeeseeeeseeeseeeeseeeeeeseeseeeseeseeseseeeeseeeseeseeeseeeeeeseeeeseeeseeeeeseeeeseeeeseeeeeeseeeeseeeeseeeeeee 


假如 你 所 在 的 开发 现场 添置 了 100 台 服 务 器 。 如 果 所 有 的 服务 器 都 
必须 设 定 同样 的 磁盘 分 区 、 选 择 初 始 化 安 痕 包 、 添 加 账户 以 及 设置 密 
码 ， 你 应 该 怎么 做 ? 

虽然 也 可 以 为 100 合 服务 需 插 入 安装 CD， 接 上 键盘 ， 一 人 台 一 台地 
配置 磁盘 分 区 ， 但 这 样 会 耗费 大 量 的 时 间 。 在 这 种 情况 下 ， 比 较 有 用 的 
工具 就 是 Kickstart。 











@.… Kickstart 的 使 用 方法 


Kickstart 的 使 用 方法 是 : 安装 Linux 时 ， 在 kernel 参数 中 加 上 
[ks=...] 这 样 的 选项 就 可 以 从 USB、 外 置 硬盘 等 外 部 存储 需 或 
HTTP、FTP 站 点 加 载 配置 文件 以 实现 安装 自动 化 。 

结合 PXE 启动， 只 要 在 插 着 网 线 和 电源 线 的 状态 下 按 下 电源 开关 ， 
即 可 有 目 动 完成 安 摊 。 并 且 不 仅 限 于 物理 服务 大 ，Kickstart 同样 也 可 用 于 
虚拟 机 的 安 儿 ， 因 此 通用 性 非常 好 。 











i 使 用 时 的 注意 事项 


需要 注意 的 是 ，Kickstart 只 能 用 于 Red Hat Enterprise Linux 系列 
(以 下 简称 RHEL 系列 ) Linux 发 布 版 本 的 安 狐 。Debian GNU/Linux 系 





GD Preboot Execution Environment， 网 络 启 动 规格 的 一 种 。 
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列 的 Preseed、Solaris 需要 使 用 JumpStart 这 种 其 他 的 安装 形式 。 

有 时 还 需要 根据 磁盘 容量 等 硬件 规格 的 不 同 来 设置 不 同 的 分 区 方 
式 。 在 引导 层 还 需要 意识 到 : 根据 所 用 的 工具 以 及 内 容 的 不 同 ， 可 以 选 
择 的 便 件 及 OS 等 也 是 有 所 差异 的 。 

















i Kickstart 的 配置 示例 


下 列 代 码 是 在 连接 网 络 的 状态 下 ， 安 装 并 启动 服务 右 的 简单 配置 示 
例 。Kickstart 的 内 容 是 将 CD 中 安装 向 导 所 问 的 问题 以 配置 文件 的 形式 
确定 下 来 。 


# Kickstart file automatically generated by anaconda. 





Tmaceall 
Wiel ==-Wiel=fto /ECED.Jalgt. ad. J ou Li Centos /0/86 6247 





1 指定 通过 FTP 来 安装 
lame Ja JB. US- 
nelweonrke ourEeeomee 


keyboard Jp106 

Zerombr 

Clearpart --all 

part / --fstype ext4 --size=1 --grow --asprimary 





1 分 区 配置 的 描述 。 设 置 为 qrow 的 话 会 将 剩余 所 有 的 磁盘 空间 都 分 配给 该 分 区 
part /var --fstype ext4 --size=40960 


part /home --fstype ext4 --size=81920 

part /boot --fstype ext4 --size=400 

part swap --size=4096 

bootloader --location=mbr --driveorder=sda --append="crashkernel=auto rhgb 
gquiet" 

timezone --utc Asia/Tokyo 

rootpw password 

user --name=defaultuser --groups=users --password=userpass 
selinux --disabled 

firewall --disabled 

authconfig --enableshadow --passalgo=sha512 

reboot me aE 

repo --name="CentOS" --baseurl=ftp://ftp.jaist.ac.jp/pub/Linux/CentOs/6/ 
Os/x86 64/ -=-cost=100 


Spackages < 指定 安装 包 的 顺序 
@base 

@console-internet 

@core 
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@debugging 
@jJapanese-support 
@large-systems 
@network-file-system-client 
@server platform 
@server-policy 
pax 

oddjob 

sgpio 

elensleme ne 
Beamkssles 
krb5-workstation 


#setup start 二 包 安 装 完成 后 运行 she11 脚 本 

Spost --log=/tmp/anaconda-post.1og #--erroronfail 
function oo mesg() od 

en 

/one SHOSLs > 


} 


oemmesem ean sy 
yum -y update 


1GG 而 SSG ese ere 

/sbin/ifconfig | /bin/mail -s "Complete Server installation." user email 
address@example.com 

l1@e) mase VMND T2088T SCRLDLY 


可 以 在 part 部 分 记载 分 区 配置 ， 在 user 部 分 建立 初始 用 户 并 设置 密 
码 。 还 可 以 配置 初始 安 站 的 软件 包 ， 并 且 在 安 痰 完成 后 日 由 地 执行 shell 
脚本 。 这 里 用 yum 命 令 将 包 更 新 到 最 新 状态 ， 最 后 通过 mai1l 命 令 通 知 
ifconfig 命 令 的 执行 结 








6.3.2 Vagrant 





eeeeeeeeeeeeeseeeeeseseeeeseeeeeeseseeeeeseseeesseeseeeseeseeeeseeeseeeeseeeeseeeseeeeseeeeeeseeeeseeeeeeeseeeeeseeeeeeeeeeseeeeeee 


开发 人 员 想 试 着 运行 下 最 新 代码 的 效 打 时 ， 应 该 准备 怎样 的 环境 才 
好 呢 ? 





e@……. 为 每 一 位 开发 人 员 准备 实体 电脑 比较 困难 


有 了 Kickstart 这 样 的 机 制 ， 为 实体 电脑 安装 OS 已 经 变 得 比较 简 
单 ， 但 如 果 为 每 一 位 开发 人 员 准 备 一 台 专 用 服务 器 的 话 ， 成 本 会 非常 
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高 。 另 外 还 有 物理 上 的 限制 ， 诸 如 没有 放置 的 空间 或 供电 不 足 等 问题 ， 
因此 为 每 一 位 开发 人 员 提 供 一 合 服务 天 是 并 不 太 现 实 的 。 





e@…… 使 用 虚拟 机 时 的 注意 事项 


解决 上 述 问题 的 办 法 之 一 就 是 将 测试 环境 构建 在 虚拟 机 上 ， 但 虚拟 
机 的 运用 、 操 作 多 少 需要 具备 特殊 的 知识 ， 有 时 可 能 无 法 顺利 地 使 用 虚 
拟 机 。 

在 还 不 能 方便 地 使 用 虚拟 机 的 情况 下 ， 可 以 在 和 staging 环境 以 及 
手头 的 开发 环境 大 致 相同 的 运行 环境 下 checkout 最 新 的 代码 ， 试 着 确认 
程序 的 动作 。 但 各 个 环境 上 应 用 程序 所 依赖 的 模块 的 安装 版 本 存在 差 
异 ， 无 法 进行 验证 的 情况 也 是 党 有 的 。 

轻松 地 搭建 虚拟 机 ， 在 不 影响 当前 使 用 环境 的 前 提 下 就 能 够 进行 尝 
试 ， 安 六 所 需要 的 模块 并 实施 验证 。 下 面 就 来 介绍 一 下 能 够 实现 上 述 功 
能 的 软件 Vagrant。 

















ss 什么 是 Vagrant 


Vagrant 主要 是 通过 CLI ( Command Line Interface ) 来 操作 名 为 
VirtualBox 的 虚拟 机 软件 的 工具 ， 由 Ruby 编写 。 这 里 说 “主要 ”， 是 因 
为 Vagrant 还 文 持 VMware fusion 的 操作 ， 并 且 通 过 安 猴 搬 件 ， 还 可 以 
实现 类 似 于 AWS 的 IaaS 虚拟 机 的 操作 。 

Vagrant 不 需要 特殊 的 配置 ， 也 无 需 通过 鼠标 进行 复杂 的 操作 。 
VirtualBox 的 运行 环境 是 多 种 平台 的 ，Windows、Mac、Linux 等 只 要 是 
x86 困 构 的 OS 都 可 以 运行 ， 因 此 能 在 多 种 OS 上 使 用 。 








e@…… Vagrant 的 安装 及 运行 方法 





旧版 本 (1.1 版 以 前 ) 的 Vagrant 采用 gem 命令 的 形式 来 安装 。 最 
新 版 本 以 RPM 或 DEB 包 的 形式 提供 ， 因 此 可 以 从 官网 “下载 并 安装 ， 


QD http:/www.vagrantup.conmy/ 
@ https:/www.virtualbox.org/ 
(3) http:/www.vagrantup.com/ 
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安装 完成 后 即 可 开始 使 用 。 安 装 包 中 除了 Vagrant 的 代码 之 外 ， 还 包括 
Ruby 的 本 体 等 ， 因 此 不 会 和 安装 对 象 机 融 上 安 闭 的 Ruby 版 本 发 生 冲 
突 。 无 论 在 运行 有 怎样 的 应 用 程序 的 环境 上 都 能 方便 地 运行 。 

首先 就 让 我 们 访问 Vagrant 的 主页 ， 下 载 最 新 的 包 并 安装 。 安 装 完 
成 后 ， 从 VagrantBox 支持 的 OS 模板 列表 “确认 镜像 的 URL， 并 启动 虚 
拟 机 。 


$ vagrant box add centos http://developer.nrel.gov/downloads/vagrant- 
boxes/CentOS-6. 3-8 GA=V2IO0LIOLOL ,Dope 
svaenrantene emos 





Smv oenaml ee 


只 需 这 几 步 操作 就 能 在 本 地 机 大 上 构筑 起 虚拟 的 CentOS 环境 。 执 
行 vagrant box add 命 令 的 部 分 就 是 将 OS 的 镜像 加 载 到 Vagrant 
中 。vagrant box add 支持 多 种 镜像 ， 可 以 通过 运行 Vagrant box 
1i st 命令 来 确认 所 支持 的 镜像 列表 。 本 例 中 设置 了 CentOS 镜像 的 
URL， 其 他 如 Ubuntu、BSD 的 镜像 等 也 可 以 在 网 上 找到 。 

接着 让 我 们 试 着 登录 到 启动 后 的 虚拟 机 环境 。 

$ vagrant ssh 

Mac 和 Linux 环境 下 可 以 直接 登录 。Windows 环境 因为 没有 安装 
ssh 命 令 ， 所 以 无 法 通过 vagrant ssh 命 令 来 进行 。 

在 Windows 环境 下 登录 虚拟 机 的 方法 有 通过 Tera Term 等 终端 进行 
SSH 登录 ， 或 者 在 Cygwin 环境 下 安装 s sh 命令 ， 通 过 执行 vagrant 
ssh 命 令 进 行 登录 。 

登录 后 可 以 对 环境 进行 各 类 验证 ， 如 果 不 再 需要 该 镜像 或 者 验证 失 
败 、 环 境 损坏 的 话 ， 能 够 直接 删除 虚拟 机 。 


$ vagrant halt 














$ vagrant destroy 

像 这 样 ， 虚 拟 机 的 关闭 以 及 删除 也 可 以 通过 命令 轻松 地 实现 。 如 果 
还 想 在 新 的 干净 的 环境 上 进行 尝试 的 话 ， 只 需 执 行 vagrant up 命令 ， 
就 能 建立 新 的 虚拟 机 环境 ， 这样 就 可 以 反复 地 进行 尝试 。 


DD http://www.vagrantbox.es/ 
@) http://sourceforge.jp/projects/ttssh2/ 
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因为 Vagrant 是 由 Ruby 编写 的 ， 所 以 和 稍 后 介绍 的 Configuration 工 
具 Chef 的 配合 度 很 高 。 结 合 使 用 Vagrant 和 Chef， 能 够 反复 地 实施 环境 
的 构建 及 服务 硕 、 中 间 件 的 配置 的 验证 。 比 起 在 本 地 环境 上 实施 上 述 处 
理 ， 建 议 准 备 好 实施 CI 的 专用 环境 ， 具 体 的 内 容 将 稍 后 讲解 。 
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6.4 配置 ( Configuration ) 


6.4.1 不 使 用 自动 化 时 的 问题 


说 起 部 署 ， 人 们 往往 只 关注 发 布 工作 ， 但 其 实 服务 需 的 构成 管理 成 
本 也 非常 高 ， 这 一 下 是 一 个 问题 。 例 如 ， 某 应 用 程序 的 运行 环境 非常 复 
杂 ， 构 建 该 环境 需要 经 过 数 十 、 数 百 个 步 又 的 操作 ， 帮 在 这 样 的 情况 下 
搭建 新 的 验证 环境 或 开发 环境 ， 会 有 怎样 的 问题 呢 ? 

笔者 所 经 历 过 的 茶 个 应 用 程序 开发 中 ， 由 于 没有 人 负责 维护 构建 环 
境 的 手册 ， 只 提供 了 正常 运行 环境 的 访问 权限 ， 因 此 此 只 能 一 边 确 认 此 
环境 上 安 凌 的 模块 及 中 间 件 的 配置 ， 一 边 构 建 手 涉 的 环境 ， 日 日 浪费 了 
时 间 和 精力 。 

利用 虚拟 化 技术 ， 充 分 利用 作为 原型 的 虚拟 镜像 ， 的 确 能 多 少 跳 过 
一 些 中 间 步 妊 ， 但 即使 是 习惯 的 人 也 要 花费 几 小 时 ,不 习惯 的 人 甚至 要 
花费 几 天 的 时 间 。 在 实际 的 开发 工作 中 ， 当 团队 人 员 增 加 或 发 生 工 作 交 
接 等 情况 时 ， 构 建 环境 以 外 的 人 也 必须 能 够 在 该 环境 上 运行 应 用 程序 。 

耗费 了 一 定 的 时 间 终 于 构建 起 了 大 致 版 本 一 致 或 相同 的 运行 环境 ， 
程序 也 开始 运行 了 。 但 这 并 不 意味 着 各 个 环境 之 间 就 绝对 一 致 。 

在 在 这 样 的 环境 下 进行 开发 ， 就 会 出 现 “ 明 明 在 本 地 环境 上 能 够 正 
各 运行 ， 但 在 测试 环境 下 就 运行 不 了 ”的 问题 。 正 是 因为 模块 间 微 妙 的 
版 本 差 寞 而 产生 了 bug。 

作为 上 述 问题 的 解决 方案 ， 可 以 使 用 配置 (Configuration ) 相关 的 
目 动 化 工具 ， 从 一 开始 就 采用 完全 相同 的 方法 对 环境 进行 安 疫 。 
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6.4.2 Cherf 





Chef 是 用 Ruby 编写 的 服务 需 配 置 的 自动 化 工具 。 只 要 准备 好 名 为 
Cookbooks (食谱 ) 的 服务 需 构 建 手册 形式 的 配置 文件 等 ， 就 能 按照 文 
件 所 记述 的 规则 为 服务 器 安装 软件 包 并 配置 中 间 件 。 

无 论 10 台 还 是 1 万 台 机 器 ， 只 需要 1 份 Cookbooks， 就 能 构筑 起 符 
合 要 求 的 环境 。 像 Facebook 这 样 大 规模 的 运 维 也 同样 使 用 Chef "。 

Chef 不 仅 限 于 大 规模 基础 设施 的 构建 ， 在 小 规模 基础 设施 构建 中 也 
能 发 挥 其 真正 的 价值 ， 因 此 即便 只 是 构建 1 人 台 机 器 的 环境 ， 也 可 以 对 其 
加 以 有 效 利 用 。 


@.…. Chef 的 构成 
Chef 的 运行 大 致 有 以 下 3 种 结构 。 








@ Chef Server ( 图 6.3 ) 


图 6.3 Chef Server 
全 二 


Chef Server 1 









(1) 添 加 Chef 客户 端 DB) 通 过 SSH 登录 


的 信息 
EE Ea 


ss ma 
@@ 在 Chef 客户 端 上 运行 
。 取 得 信息 


。 执行 Chef 
Chef Server Chef 客户 端 














(DD http:Wwww.infoq.com/cn/news/2013/02/facebook-chef 
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@ Chef Solo+ Knife Solo (图 6.4 ) 
© Chef Solo ( 图 6.5 ) 


图 6.4 Chef Solo + Knife Solo 
/ 、 


\_Chef Solo& Knife Solo J) 


(运行 Knife Solo 
。 发送 Cookbooks 等 信息 
。 在 服务 器 上 运行 Chef Solo 


















图 6.5 Chef Solo 


Chef Solo 4 


采用 某 种 方式 获取 Cookbooks 等 
中 运行 Chef Sole 








Ne 7/ 

@~@ 所 使 用 的 Cookbooks 可 以 是 相同 的 。 在 由 1 一 2 台 服 务 器 
构成 的 环境 下 ， 可 以 从 Chef Solo 的 构成 方式 开始 ， 然 后 随 着 服务 器 台 
数 的 增加 ， 再 考虑 构建 Chef Server 的 环境 。 

为 了 学 习 Chef 最 基本 的 使 用 方法 ， 这 里 我 们 以 利用 Chef Solo 构建 
简单 的 Web 服务 器 环境 为 例 进行 讲解 。 

Chef 的 安装 和 Vagrant 一 样 可 以 采用 RPM 等 包 的 形式 进行 。 过 去 
是 通过 gem 命 令 进 行 安装 的 ， 现 在 安装 包 中 还 提供 了 Ruby 的 本 体 ， 
此 不 会 和 OS 上 的 Ruby 发 生 版 本 依赖 等 问题 ， 能 够 直接 使 用 Chef。 
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@… 目录 构成 和 文件 配置 
这 次 介绍 的 Chef 的 文件 和 目录 结构 如 图 6.6 所 示 。Chef 的 配置 文 
件 统 称 为 Cookbooks， 其 中 特别 是 Recipe 和 Template 起 者 主要 的 作用 。 
下 面 就 对 这 些 文件 逐个 地 进行 讲解 。 
6.6 ”Chef 的 文件 和 目录 结构 


三 S 















chef-repo 


cookbooks 


reclpes 
default.rb 
templates 

default 
virtualhost.conf.erb 
node.json 
roles 


setup.json 


solo.rb 











文件 和 目录 可 以 用 Chef 的 命令 行 接口 Knife 目 动 生成 。 
$ knife cookbook create <Cookbook name> -OO <output dir> 
这 样 就 能 目 动 生成 必要 的 目录 结构 和 文件 ， 所 以 在 第 一 次 构建 Chef 
环境 时 ， 请 试 着 执行 上 述 命 令 。 但 是 指定 执行 对 象 Recipe 的 node.json 
等 配置 文件 需要 手动 生成 。 

















@.……… node.json 





这 个 文件 是 运行 Chef 所 必需 的 文件 。 这 次 node.json 中 记载 的 内 容 
照 了 roles 目录 下 的 setup.json。 本 例 中 记述 的 是 执行 main 目录 下 的 名 





Wp 
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为 default.rb 的 Recipe。 
{ 


ns te 





"zole[setupj]o ae 


| setup.json 








这 个 文件 束 是 配置 实际 的 Recipe 文件 的 地 方 ， 同 时 还 记载 7 
attribute。attribute 定义 的 变量 能 在 Recipe 文件 和 Template 文件 中 使 用 。 
{ 





aamen se Ne le en 
"override attributes": { 
"apache": { 
"documentroot": "/var/www" +- 能 够 在 recipe 或 template 中 使 用 的 变量 
} 
}, 
asonmeaase ues 
"description": "Setup Examplep Program", 
ee te 人 
en St 


"recipe[main: :default]" 





这 个 文件 是 运行 Chef 所 必需 的 文件 。 记 载 有 Chef 的 Cookbooks 的 
路 径 以 及 roles 的 文件 路 径 。Chef 是 用 Ruby 编写 的 ， 所 以 路 径 的 配置 同 
样 可 以 使 用 Ruby 的 File.expand path。 

其 他 Ruby 的 语法 也 可 以 使 用 ， 但 原则 上 作为 服务 器 构建 的 自动 化 
工具 应 该 尽量 将 所 使 用 的 语言 限制 在 Chef 的 DSL (Domain Specific 
Language， 领 域 语言 ) 范围 内 。 


Cookbook path File.expand path("../cookbooks", FILE ) 
role path File.expand path("../roles", FILE ) 
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@.…… default.rb 








这 个 文件 就 是 被 称 为 Recipe 的 重要 的 配置 文件 。 在 package 那 一 行 
中 ，RHEL 系列 的 话 使 用 yum/rpm，Debian GNU/Linux 系列 的 话 使 用 
apt/deb 来 安装 Apache。 

template 是 在 部 署 配置 文件 时 使 用 的 ， 这 里 记述 的 处 理 是 在 Apache 
的 conf.d 目录 下 添加 新 的 配置 文件 。variables 用 于 在 Recipe 中 接收 
template 的 变量 。Chef 中 对 变量 的 处 理 是 非常 重要 的 。 通 过 记述 在 
attribute 中 ， 承 可 以 在 Recipe 和 template 中 作为 变量 使 用 ,但 attribute 
可 以 记载 在 几 个 文件 中 ， 并 且 有 着 各 目 不 同 的 优先 级 。 本 书 不 做 详细 的 
介绍 ， 只 是 提 一 下 优先 级 最 低 的 attribute/default.rb 文件 中 所 记载 的 是 作 
为 全 体 的 默认 值 ， 关 于 服务 需 的 作用 、 测 试 环境 、 正 式 环境 这 样 不 同 环 
境 的 环境 变量 ， 可 以 记载 在 Role 或 Environments 中 。 通 过 灵活 运用 
attribute， 能 人 够 调整 单个 Cookbooks 使 其 适用 于 各 种 环境 。 

在 directory 那 行 中 ， 虽 然 只 定义 了 新 建 指定 的 目录 ， 但 需要 注意 的 是 
这 里 用 到 了 和 定义 在 attribute 中 的 #{node[:apache] [:documentroot]} 
这 样 的 变量 。 

git 那 行 记 述 了 checkout 代码 库 的 master 分 文 到 指定 的 目录 下 。 通 
过 指定 action : sync，checkout 时 就 会 更 新 最 新 的 版 本 。 

在 service 那 行 中 ， 可 以 操作 中 间 件 的 局 动 或 分 止 。 这 里 定义 为 司 动 
Apache。 






































package "httpd" 全 ia 


template "/etc/httpd/conf.d/#{ENVI['HOSTNAME'] } .conf" do 
Sacs le em na 
mode 0644 
GWner "YooE" 
rou "Goc! 
variables({ 
:env hostname > THENVITHOSTNAME' IT 
加 


end 


directory "#{node[:apache] [:documentroot] }/#{ENVI['HOSTNAME'] }" do 
action :create (mepa::Elqselo Tl 
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end 


gi WV/var/www/t(ENVIHOSTNAME"]}" de 
repository "https://github.com/example/program.git 
reference "master" 
action :sync 

end 


service "httpd" do 


action :start bl 


end 


@…… virtualhost.conf.erb 


这 是 Recipe 中 指定 的 Template 文件 。 这 里 可 以 内 骸 attribute 或 
Recipe 文件 中 以 variables 形式 指定 的 变量 。 这 里 可 以 使 用 Ruby 的 erb 
模板 。 


VeevualaoadEe “S880 
ServerAdmin serveradmin@<%= @env hostname %> 
DocumentRoot <%$= @node.apache.documentroot %>/<%= @env hostname $> 
ServerName <%= @env hostname %> 
ErrorLog logs/<$%= @env hostname %>-error log 
CustomLog logs/<%= @env hostname $>-access log combined 
</ VileEuaL OSES 


@…… Chef 的 运行 方法 和 运行 结果 


只 需 指 定 node.json 和 solo.rb， 就 可 以 运行 Chef Solo。 


$ sudo chef-solo -] node.json -c solo.rb 


执行 Chef 后 显示 如 下 结 


[root@ip-10-132-183-178 chefl# chef-solo -] node.Json -c solo.rb 
Seoehaeimeneneenelme nn ns ns 
GemionilmmeesokecclISsR 
Converging 5 resources 
Recipe: main: :default 
solaeel eon < 安装 httpd 
- install version 2.2.25-1.0.amznl of package httpd 


* template[/etc/httpd/conf.d/ip-10-132-183-178.conf] action create 
- create new file /etc/httpd/conf.d/ip-10-132-183-178.conf 
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- update content in file /etc/httpd/conf.d/ip-10-132-183-178.conf from 

none to 3cb554 部署 Template 中 指定 的 文件 

--- /etc/httpd/conf.d/ip-10-132-183-178.conf 2013-09-22 
OR 2 5 27/23E E57 -0000 

+++ /tmp/chef-rendered-template20130922-6866-6hkxkf-0 2013-09-22 
lOs dl2a2s.290335967 T0000 

@@ -0,0 +1,8 @@ 

+<VirtualHost *:80> 


十 ServerAdmin serveradmin@ip-10-132-183-178 
十 DocumentRoot /var/www/ip-10-132-183-178 
+ ServerName ip-10-132-183-178 
十 ErrorLog logs/ip-10-132-183-178-error 1og 
+ CustomLog logs/ip-10-132-183-178-access log combined 
/Va le 1 文件 的 内 容 被 替换 成 了 attribute 的 值 
I 
- Change mode from '' to '0644' 
- Change owner from '' to 'root' 
-oleaeemen eu ine 


* directory[/var/www/ip-10-132-183-178] action create 
- create new directory /var/www/ip-10-132-183-178 
1 建立 了 由 attribute 指 定 的 目录 
* git[/var/www/ip-10-132-183-178] action Sync 
- clone from https://github.com/example/program.git into /var/www/ 
ip-10-132-183-178 < 使 用 git 命 令 进行 clone 
- Checkout ref 05e45129blfdibbadl8c790fcd814ba36403cabl branch master 





-servieselleeoell eeeron gearsec 一 启动 httpda 
- Start service service [httpdj] 


Chef Client finished, 5 resources updated 


使 用 这 个 Cookbooks 安装 Apache， 并 将 服务 器 配置 为 基于 名 称 的 
虚拟 主机 ， 在 DocumentRoot 中 通过 Git checkout 任意 程序 并 启动 
Apache。 到 此 为 止 的 处 理 就 实现 目 动 化 了 。 如 有 果 是 checkout 后 能 够 立即 
使 用 的 应 用 程序 的 话 ， 那 么 通过 上 述 一 连 串 的 处 理 ， 环 境 构筑 应 该 就 能 
完成 了 。 














@…… 使 用 Chef 的 优点 


可 以 看 出 用 Chef 的 DSL 编写 的 Cookbooks 非常 容易 理解 ， 学 习 成 本 
非常 低 。Cookbooks 是 用 Ruby 的 代码 编写 的 ， 因 此 还 可 以 进行 版 本 管 
理 ， 即 相当 于 在 版 本 管理 系统 上 保存 了 “服务 瞬 正 常 状 态 及 其 历史 记录 ”。 
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至 今 为 止 服 务 需 的 结构 和 构建 管理 是 被 分 制 开 的 ， 通 过 对 Cookbooks 
进行 版 本 管理 ， 服 务 需 的 构建 有 了 历史 记录 管理 。 并 且 只 需 执行 Chef 
命令 就 能 实现 服务 右 构 建 的 自动 化 。 也 就 是 说 ， 用 Ruby 的 代码 来 管理 
服务 顺 状 态 的 “Inffrastructure as Code” 这 种 服务 器 管理 的 新 时 代 已 经 到 
外 


@…… 使 用 Chef 时 的 注意 事项 


使 用 Chef 时 有 一 点 需要 注意 ， 那 就 是 既然 已 经 使 用 Chef 对 服务 大 
进行 管理 ， 就 要 禁止 手动 构建 服务 顺 ， 要 记 住 必须 使 用 Chef 进行 相关 
作业 。 如 采 手 动 地 安装 包 、 修 改 配 置 等 ， 就 会 造成 服务 右 的 状态 和 
Cookbooks 中 的 定义 发 生 痛 离 ， 而 为 了 达到 相同 的 状态 就 不 得 不 执行 多 
条 命令 ， 并 且 只 有 进行 此 操作 的 人 才 知 道具 体 的 内 容 。 但 如 采 将 上 述 操 
作 记 载 到 Cookbooks 的 话 ， 那 么 谁 都 可 以 通过 1 条 Chef 命令 将 服务 顺 
配置 到 相同 的 状态 。 

从 构建 管理 的 角度 来 看 ， 不 使 用 Cookbooks 而 手动 构建 服务 需 也 是 
不 明智 的 。 全 部 采用 Chef 来 构建 环境 ， 即 使 最 初 只 需要 1 条 命令 就 能 
完成 构建 工作 ， 编 写 Recipe 文件 也 是 必要 的 。 虽 然 对 编写 Recipe 的 工 
作 感 到 焦 踩 不 安 的 人 不 在 少数 ， 但 经 过 1 个 月 、1 年 的 时 间 后 ， 随 着 配 
置 修改 的 内 容 不 断 积累 ， 你 就 会 感受 到 使 用 Chef 所 种 来 的 好 人 处。 














@…… 使 用 Chef 的 时 间 点 


可 以 在 构建 开发 环境 的 阶段 ， 也 就 是 开始 开发 前 后 一 段 时 间 开 始 使 
用 Chef。 使 用 和 开发 环境 、 测 试 环 境 、 正 式 环 境 同样 的 Cookbooks， 
环境 而 有 所 差异 的 配置 ， 可 以 全 部 通过 attribute 来 控制 。 

如 果 想 进一步 了 解 Chef 的 话 ， 可 以 参考 相关 资料 。 
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6.4.3 serverspec 





@…… 什么 是 serverspec 


如 宁 说 Chef 是 用 代码 来 管理 服务 需 环 境 构 建 的 工具 ， 那么 
serverspec 就 是 对 服务 需 的 构成 进行 单元 测 ae 。 从 名 字 就 可 
以 看 出 ， 其 内 部 使 用 了 Ruby 的 BDD 框架 RSpec 。 

serverspec 虽然 不 是 直接 进行 配置 的 工具 ， 但 为 了 确保 Chef 等 通过 
代码 管理 服务 旧 构 建 的 工具 能 够 持续 地 正常 运行 ，serverspec 可 以 说 是 
必 不 可 少 的 测试 框架 











@…… serverspec 的 安装 


执行 如 下 命令 来 安装 serverspec 的 运行 环境 。 


$ gem install serverspec 
$ serverspec-init 
Select a backend type: 


1) SS5 
2 Eeenmn eu 


Select number: 2 


serverspec 文 持 远程 服务 天 的 测试 ， 于 测试 本 地 服务 大 
(图 6.7 )。 执 行 测试 需要 root 权限 ， 或 者 通过 sudo 来 执行 。 第 一 次 初始 
化 时 无 论 选择 远程 主机 ( SSH ) 还 是 本 地 主机 ( Exec (local) ), 之 后 
都 可 以 进行 切换 ， 以 验证 为 目的 的 话 可 以 选择 “2”， 并 制作 测试 用 例 。 


G http://rspec.info/ 
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图 6.7 ”serverspec 的 运行 环境 
We ~ 


serverspec 远程 主机 人 A 
CdDSSH exec bash 
(2) Exec ( Local ) 














serverspec 服务 器 





远程 主机 B 
serverspec via SSH… (4) |exec bash < 


Exec ( Local ) …: a 
- 远程 主机 C 
exec bash 











e…… 测试 文件 的 记述 方式 
执行 serverspec-init 命 令 , 会 自动 生成 文件 和 目录 (图 6.8)。 


图 6.8 ”serverspec 的 目录 结构 


的 S| 











Rakefile 


spec 


localhost 


httpd_spec.rb 


spec_helper.rb 








NN a 

localhost 目录 下 的 xxxx_spec.rb 文件 就 是 测试 用 例 。 假 设 在 执行 之 
前 提 到 的 Chef 的 Cookbooks 后 进行 测试 ， 我 们 来 试 着 制作 测试 用 例 。 
测试 的 内 容 包 括 确 认 httpd 的 安装 及 局 动 、 确 认 通 过 template 部 暂 的 文 
件 是 否 存 在 ， 以 及 对 文件 内 容 的 检查 。 








@…… httpd_spec.rb 


ea SEE 


describe package('httpd') do 
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it { should be installedq } 和 一 检查 httpd 的 安装 
end 
describe service('httpd') do 
加 { sinevelkell en a } 


end 


describe port (80) do 





it { should be listening } 仿 查 是 否 在 侦 听 80 端 口 
end 
eheck config "ete/hnttod/ eont eo/HIENV I HOSTNAME I Cont 


elelslensiee eineekee nlite le 
i ( Bhowlel be file } < 检查 通过 template 部 署 的 文件 的 有 无 





it { should contain "ServerName #{ENV['HOSTNAME'] }" } 
end 1 检查 文件 的 内 容 


lelslenalesi ne eniae de 
it { should be mode 644 } 
it { should be owned by 'root' } 
ileohoul De grouped ineo rooer 


end 


除了 httpd 以 外 ， 我 们 再 试 着 添加 git clone 是 否 成 功 执行 的 测 
斌 用例。 新 建 名 为 spec/localhost/git_ spec.rb 的 文件 ， 如 下 所 示 。 


@.……… git_spec.rb 


neemhen se 


describe file("/var/www/#{ENVI['HOSTNAME'] }") do 
i should be girectory | 
end 1 检查 git clone 是 否 成 功 执行 





@…… Serverspec 的 执行 方法 及 执行 结果 


执行 serverspec 的 测试 时 ， 在 Rakefile 层 执行 下 面 的 命令 。 


$ rake spec 
执行 后 会 显示 如 下 结 


/usr/bin/ruby -S rspec spec/localhost/git spec.rb spec/localhost/httpd 
spec.rb 
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Einished in 0.21744 seconds 
9 examples, 0 failures 


在 上 述 例子 中 ， 可 以 确认 9 个 测试 用 例 都 通过 了 。 测 试 失败 的 话 ， 
failures 的 数目 会 增加 。 如 果 要 输出 测试 的 详细 内 容 ， 可 以 设置 SPEC 
OPTS="--format=dqocumentation--colouzu 这 样 的 环境 变量 ， 





就 能 输出 RSpec 的 documentation format。 

要 注意 的 是 几乎 所 有 serverspec 的 测试 用 例 都 被 描述 为 了 “should 
be xxxxx”， 一 看 便 知 这 是 在 对 服务 需 当 前 的 状态 进行 检查 。 正 因为 可 
以 像 这 样 以 近似 自然 语言 的 形式 来 描述 测试 用 例 ， 所 以 测试 用 例 还 可 以 
被 当 作 服务 硕 的 需求 规格 书 来 合用， 制作 非 党 简单 。 





@…… Serverspec 的 优点 


serverspec 的 特别 优秀 之 处 在 于 测试 的 执行 不 依赖 于 Ruby 的 运行 环 
境 这 一 点 。 测 试 代码 的 执行 是 通过 shell 命令 进行 的 ， 因 此 只 需要 在 运 
行 serverspec 的 服务 般 上 安 闻 Ruby 和 serverspec， 远 程 服 务 硕 只 需要 能 
够 通过 SSH 登录 即 可 进行 测试 。 

serverspec 还 支持 多 种 OS， 可 以 对 RHEL 以 外 的 OS 如 Solaris、 
Debian GNU/Linux 进行 测试 。 

使 用 serverspec 能 够 对 任意 环境 应 有 的 状态 进行 检查 ， 配 合 Chef 一 
起 使 用 ， 就 能 够 放心 地 对 服务 部 进 行动 态 的 配置 修改 。 











6.4.4 最 佳 实践 (其 1 ) 


在 讲解 Chef 时 提 到 了 “Infrastructure as Code” 这 个 单词 ， 为 了 保 
证 代码 的 质量 ， 进 行 测 试 是 很 重要 的 ， 并 且 测 试 还 必须 能 够 持续 地 执 
行 。 在 实现 了 服务 需 构 建 的 目 动 化 之 后 ，CI 的 实施 就 变 得 非常 重要 
(图 6.9 )。 
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图 6.9 Jenkins+Chef+serverspec+Vagrant 
7 \ 


(5) 将 测试 结果 反馈 给 Jenkins 


Serverspec]j 


(Ocheckout Chef 的 Cookbook 和 
serverspec 的 测试 用 例 

(3) 执 行 Chef、 配 置 服务 器 

(4 通过 serverspec 对 服务 器 的 状态 进行 测试 














(用 Vagrant 局 动 乎 
净 的 服务 器 实例 







Vagrant 
( 主 服务 颖 ) 











让 我 们 试 着 结合 Jenkins+Chef+serverspec+Vagrant 来 实际 进行 上 述 
处 理 。 

Vagrant 提供 了 启动 虚拟 服务 器 时 执行 Chef 或 shell 的 机 制 ， 这 使 得 
构建 理想 中 的 环境 成 为 可 能 。 执行 vagrant init 时 会 生成 名 为 
Vagrantfile 的 虚拟 机 配置 文件 。 

在 Vagrantfile 中 添加 Chef Solo 或 shell 脚 本 等 服务 器 预 处 理 
( provisioning ) 的 相关 内 容 ， 在 第 一 次 执行 vagrant up 时 ， 这 些 处 理 
会 被 执行 。 除 第 一 次 启动 之 外 ， 可 以 通过 启动 时 添加 选项 vagrant up 
--provision，, 或 者 在 虚拟 服务 大 启动 后 运行 Vagrant provision 
来 执行 上 述 预 处 理 。 

在 GitHub 上 设 有 Chef 或 serverspec 的 代码 库 的 情况 下 ， 通 过 配置 
Webhooks， 并 设置 在 执行 Vagrant 的 预 处 理 的 过 程 中 启动 Jenkins 的 任 
务 ， 这 样 CI 环境 就 构建 完成 了 。git 代码 库 的 话 可 以 使 用 git hooks"， 几 
乎 所 有 的 代码 库 都 支持 在 commit 或 push 的 钧 子 中 执行 命令 。 

Vagrantfile 中 可 以 通过 关键 字 ijnline :来 提示 shell 脚本 。 下 面 的 


Vagrantfile 会 执行 git clone 命 令 。 











QD) http://git-scem.com/book/zh/v1/ 自 定义 -Git-Git 挂 钓 
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@…… Vagrantfile 


neler ul 
HS ly 


# Vagrantfile API/syntax version. Don't touch unless you know what you're 
doingl! 


WA RENE EI EON 2 


Vagrant .configure (VAGRANTFILE API VERSION) do |config | 


Gomer no enmiesy 
Gonfige, vi,Drovisicon rahelly ， -chef 的 安装 


inline: "curl -L https://www.opscode.com/chef/install.sh | bash" 


contig vi provision Jehet soleo" qo |ehefl| 
elnerssalels Sen ema 


1 设置 安装 git 和 serverspec 的 Recipe 文 件 


end 


end 


Si mn *-clone Cookbooks 和 测试 用 例 
inline: "rm -rf cookbooks serverspec && git clone git@github.com/my/ 
eeoolklboeoks se Ne 


config.vm.provision "shell" ， 全 执行 clone 下 来 的 Cookbooks 


inline: "cd cookbooks serverspec/chef-repo && chef-solo -j node.json 


“esoloN lo 


omni nv snes 最 后 执行 Serverspec 


inline: "cd cookbooks serverspec/serverspec && rake spec" 


end 


通过 指定 add recipe 在 主 服务 右上 准备 好 Recipe 文件 ， 就 会 癌 
虚拟 服务 硕 目 动 部 署 Recipe 文件 并 执行 Chef Solo( 图 6.10 )。 还 可 以 通 
过 指定 cookbooks_patnh 来 使 用 定制 过 的 Cookbooks。 
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6.10 ”指定 add_recipe 的 情况 下 的 目录 结构 


厂 人 











Vagrantfile 


cookbooks 


reclpes 


default.rb 








、 J 
由 于 Vagrant 本 体 中 没有 提供 serverspec， 因 此 通过 ijnline :来 执 
行 。 或 者 也 可 以 使 用 名 为 vagrant -serverspec 的 插件 。 





@…… default.rb 


package "git" 

package "ruby" 

package "rubygems" 

gemeelelkeee mn ene 
GRASS 

end 


这 只 是 服务 器 构建 CI 的 一 个 例子 。 将 Vagrant 部 分 替换 为 Docker” 
等 技术 也 可 以 实现 相同 的 功能 ，Chef 部 分 也 可 用 puppet 来 代替 。 
serverspec 部 分 也 可 以 用 Cucumber Chef” Test Kitchen“ 等 测试 框架 , 这 
里 的 重点 在 于 要 选择 团队 最 易于 使 用 的 、 适 合 自 己 的 工具 ， 而 不 是 局 限 
于 本 书 中 所 提 到 的 工具 。 这 对 于 持 绢 sm en 蕴 重 要 
的 ， 因 此 工具 的 选择 可 以 在 层 重 地 交流 沟通 后 再 决定 。 











6.4.5 ”最 佳 实践 (其 2) 





因为 重视 硬件 性 能 或 受 服务 合同 上 的 限制 ， 正 式 环境 中 使 用 物理 服 


https:/www.docker.10/ 
http://puppetlabs.com/ 
http:/www.cucumber-chef.org/ 
https://github.com/test-kitchen/test-kitchen 


©OOOO 
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务 器 ”的 现场 不 在 少数 。 在 这 样 的 情况 下 ， 比 较 理想 的 是 尽量 避免 手动 
升级 服务 硕 。Kickstart 能 够 实现 物理 服务 如 的 OS 安装 的 目 动 化 。 通 过 
组 合 使 用 Kickstart+tCheftserverspec， 能 够 缩短 服务 人妖 从 投入 到 开始 提供 
服务 的 时 间 (图 6.11 )。 


图 6.11 ”通过 Kickstart+Chef+serverspec 实现 服务 器 安装 自动 化 的 例子 


服务 器 的 装配 、 配 线 、 接 入 电源 
运行 Kickstart 的 准备 工作 ( PXE 局 动 等 ) 


设置 语言 、 时 区 


Kickstart 


构建 Chef+serverspec 运行 环境 


checkout Cookbooks 和 serverspec 的 测试 用 例 


执行 Chef 


| checkout 应 用 程序 
配置 服务 器 应 用 程序 


配置 对 应 运行 级 别 的 服务 自动 启动 


Chef + serverspec 


[wh] 
Rm | 














QD ”相对 于 虚拟 服务 器 来 说 。 译 者 注 
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6.4.6 ”实现 物理 服务 器 投入 运营 为 止 的 所 有 步骤 的 自动 化 


Kickstart 同样 适用 于 虚拟 环境 的 安装 ， 因 此 可 以 在 VirtualBox、 
Xen、KVM 等 上 面 事先 对 这 样 的 流程 进行 验证 。Chef 和 serverspec 的 组 
合 可 以 用 来 进行 测试 ， 并 且 通 过 建立 之 前 叙述 的 构建 服务 器 的 CI 环境 ， 
还 可 以 实现 频繁 地 构建 服务 器 ， 这 样 的 成 功 案例 已 经 有 很 多 了 ， 因 此 可 
以 将 执行 Chef 这 一 步 之 前 的 软件 包 安 装 以 及 和 便 件 相关 的 分 区 设置 等 
区 由 Kickstart 来 处 理 。 
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6.5 编 配 ( Orchestration ) 


6.5.1 发 布 作业 的 反面 教材 


这 里 的 编 配 大 致 上 可 以 简单 地 理解 为 发 布 作业 的 自动 化 。 下 面 举 一 
些 发 布 作业 中 的 反面 教材 ， 如 果 其 中 没有 一 条 和 你 所 在 的 项 目 相符 合 的 
话 ， 可 以 直接 跳 过 本 节 。 








e@ 手动 进行 发 布 作 业 

e@ 发 布 作 业 的 内 容 每 次 都 不 相同 

e@ 发 布 作 业 需 要 特殊 的 知识 ( 其 他 人 不 知道 如 何 发 布 ) 
e@ 不 能 反复 进行 任意 次 数 的 发 布 





什么 是 发 布 ? 发 布 可 以 理解 为 通过 SSH 登录 到 远程 服务 天， 将 代码 
切换 到 最 新 的 分 文 并 进行 更 新 数据 库 等 操作 。 小 型 项 目的 发 布 ， 经 过 几 
个 到 几 十 个 步 又 的 操作 可 能 就 结束 了 。 而 一 定 规 模 的 项 目的 发 布 ， 则 需 
要 经 过 数 百 以 至 于 数 和 干 个 步 又 。 

手动 实施 上 述 工 作 不 仅 会 耗费 大 量 的 时 间 ， 对 于 负责 发 布 的 工作 
人 员 的 体力 也 是 极 大 消耗 。 因 此 这 样 的 情况 下 要 反复 地 进行 发 布 是 不 现 
实 的 。 

对 正式 环境 实施 的 发 布 总 是 会 伴随 看 失败 的 风险 。 将 发 布 失败 的 可 
能 性 降 为 零 是 不 可 能 的 ， 但 有 方法 让 它 接 近 于 零 。 那 就 是 推进 发 布 作业 
的 日 动 化 。 在 测试 环境 以 及 staging 环境 上 反复 演习 目 动 化 的 发 布 并 进 
行 验证 ， 在 正式 环境 之 前 发 现 问题 ， 然 后 修改 有 问题 的 内 容 ， 青 反复 地 
对 发 布 进行 演练 ， 这 样 就 能 降低 在 正式 环境 中 发 生 错误 的 风险 。 
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6.5.2 Capistrano 





seeeeeeeeeeseeseeseeeseeeeseseeseeseeesseseseeseeseeseeseeeeeseeseeseeseeesseeeeseeeeseeeseeseeeeseeseseseeeeeeseeeeeeeoeeeseeee 





6.4 节 中 介绍 了 用 Ruby 编写 的 Chef 和 serverspec， 发 布 作业 的 目 动 
化 方面 也 有 用 Ruby 编写 的 非 第 强大 的 工具 Capistrano。 这 球 工 具 为 
Ruby on Rails 框架 项 目的 副产品 ， 支 持 Ruby on Rails 应 用 程序 的 部 署 。 
使 用 Ruby 以 外 的 语言 或 框架 编写 的 应 用 程序 的 发 布 同样 可 以 使 用 
Capistrano ， 并 且 已 经 有 了 很 多 这 样 的 实例 。 





@…… Capistrano 的 系统 构成 
使 用 Capistrano 时 的 系统 构成 如 图 6.12 所 示 。 


图 6.12 Capistrano 的 构成 
有 





区 | 忌 
人 role:AP 1 


应 用 程序 










a 


i - 
执行 服务 器 | ww- 一 一 一 一 一 一 一 一 
| 一 一 role:DB， 


TI 
MA 


中 从 Capistrano 执行 服务 器 对 多 个 应 用 程序 服务 器 
同时 执行 命令 


(从 Capistrano 执行 服务 器 对 多 个 DB 服务 器 同时 


执行 命令 














(D http://rubyonrails.org/ 
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只 需 在 执行 Capistrano 的 服务 大 上 安装 即 可 使 用 。 也 就 是 说 ， 
Capistrano 采用 的 是 Push 型 的 架构 。 不 需要 在 发 布 对 象 的 服务 冀 上 安 
装 代 理 等 ， 只 需要 确保 执行 Capistrano 的 服务 融 能 够 通过 SSH 登录 就 
可 以 了 。 

例如 ， 将 多 个 服务 右 按 角色 归纳 为 应 用 程序 服务 兹 和 数据 库 ( DB ) 
服务 絮 ， 对 应 用 程序 服务 器 执行 代码 更 新 的 任务 ， 在 数据 库 服 务 磊 上 为 
了 修改 数据 库 模 式 而 进行 Dumop 等 任务 ， 这 些 发 布 作业 都 可 以 通过 
Capistrano 一 并 执行 。 

像 这 样 简 单 旦 频繁 的 发 布 作业 ， 在 运 维 中 会 频繁 地 出 现 。 频 度 高 的 
时 候 每 天 、 每 小 时 都 要 进行 。 用 Capistrano 实现 上 述 作 业 的 目 动 化 ,无 
论 重 复 多 少 次 都 能 够 毫 无 差 池 地 完成 。 











@… Capistrano 的 安装 





Capistrano 从 安装 到 初始 化 只 需要 执行 数 条 命令 即 可 ， 因 此 可 谓 是 
使 用 门槛 相当 低 的 工具 。 


Snecma na 
S GaDlfy . 


执行 capify 命 令 会 生成 部 署 配置 文件 的 模板 ( 图 6.13 )。 
图 6.13 ”部署 配置 文件 模板 的 构成 

















三 和 
Capfile 
config 
deploy.rb 
2 
i deploy.rb 





这 里 以 癌 webl 和 web2 这 两 个 应 用 程序 服务 硕 部 署 文件 为 例 来 讲解 
deploy.rb 的 配置 。 
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role :web, 'webl' , 'web2' 


Sack oe alsl elle wl 
waleoad("/use/local/sre/deoley £1ileu, W/Emi!, sviea = GD) 
run "uname -a > /tmp/uname file" 
download "/tmp/uname file", 

"/tmp/uname file.s$CAPISTRANO:HOSTS" 
end 


使 用 upload 向 远程 的 webl、web2 服务 需 部 署 文件 ， 还 能 够 在 
webl、web2 服务 如 上 执行 通过 run 设 置 好 的 命令 。 本 例 中 会 执行 
uname 命 令 ， 并 将 标准 输出 定位 到 /tmp/uname file。 

最 后 设置 用 download 命令 来 回收 /tmp/uname file。 保存 回 收文 件 的 
路 径 中 设置 有 $CAPISTRANO: HOSTS 这 样 的 变量 ， 这 是 因为 在 以 多 个 
服务 天 为 对 象 的 情况 下 ， 文 件 名 相同 会 造成 原 有 文件 被 禾 盖 ， 因 此 用 远 
程 服务 项 名 来 蔡 换 部 分 文件 名 。 





@…… Capistrano 的 执行 方法 


meaneleokey eels 


虽然 需要 事先 确保 作为 执行 对 象 的 webl、web2 服务 顺 能 够 通过 
SSH 登录 ,但 之 后 只 需要 记述 不 满 10 行 的 配置 文件 ， 无需 反 复 操作 就 
能 确保 执行 相同 的 命令 。 

即便 部 署 对 象 的 台数 增加 ， 也 只 需 在 role 中 添加 对 象 服务 右 ， 并 执 
行 cap 这 1 条 命令 ， 这 样 所 有 的 工作 就 完成 了 。 从 有 1 一 2 台 部 署 的 对 
象 服 务 器 时 开始 ， 将 反复 实施 的 作业 做 成 task 并 由 Capistrano 来 实施 ， 
这 样 即 便 台 数 增加 也 应 该 可 以 轻松 应 对 了 。 




















6.5.3 Fabric 





seeeeeeeseeeeseeseeseeeeeseeseeseeseeeseesseseeeeseeeseseeeeeeeseseeseseeeesseeseeeseeeseseeseeeeeseseeseseeeseeseeseeseeeeeeeeseeeseeeseeseeee 





和 Capistrano 相同 ，Fabric 也 是 一 款 通过 SSH 登录 到 多 台 远 程 服务 
器 ， 按 顺序 执行 作业 的 工具 ， 由 Python 编写 。 功 能 上 和 Capistrano 几乎 
完全 相同 ， 比 较 大 的 区 别 在 于 Capistrano 基本 上 是 并 行 执行 处 理 ， 而 
Fabric 则 能 够 简单 地 在 串 行 、 并 行 处 理 间 切换 。 

一 般 认 为 为 了 高 效 、 快 速 地 进行 发 布 作 业 ， 并 行 处 理会 比较 理想 ， 
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实际 中 因为 要 确保 安全 地 按照 手册 进行 操作 ， 要 以 串 行 方式 处 理 的 情况 
并 不 少见 。 在 6.6 下 中 我 们 将 介绍 无 需 停 止 服务 就 可 以 进行 的 零 停机 时 
间 部 署 ( Zero Downtime Deployment )， 如 果 设 定 了 将 两 人 台 Web 服务 兢 
依次 从 网 站 的 负载 均衡 器 上 人 解除， 进行 更 新 后 青 添加 回去 这 样 的 做 法 ， 
使 用 Fabric 就 能 够 简单 地 实现 。 


e@……Fabric ( 串 行 执行 ) 的 情况 


@ 从 负载 均衡 器 解除 服务 器 A 
Q 更 新 服务 器 人 
四 将 服务 器 A 加 回 负 载 均衡 器 
@ 从 负载 均衡 器 解除 服务 器 B 
四 更 新 服务 器 B 
© 将 服务 器 B 加 回 负 载 均衡 器 


在 上 述 例子 中 ， 执 行 到 和 母 一 个 步 又 时 ， 就 完成 了 一 半 的 发 布 工作 ， 
更 新 完 的 服务 也 将 公开 。 


e@…… Capistrano ( 并 行 执行 ) 的 情况 


@ 从 负载 均衡 器 解除 服务 器 A 
@ 从 负载 均衡 器 解除 服务 器 B 
人 @ 更 新 服务 器 A 
@@ 更 新 服务 器 B 
© 将 服务 器 A 加 回 负 载 均衡 器 
© 将 服务 器 B 加 回 负 载 均衡 器 


Capistrano 在 种 一 四 步 时 服务 停止 ， 和 预期 的 动作 不 相符 。 虽 然 
有 一 些 用 Capistrano 实现 串 行 处 理 的 解决 方案 ， 但 使 用 直接 文 持 串 行 处 
理 的 Fabric 更 为 方便 。 








@.…… 理解 本 地 服务 器 和 远程 服务 器 操作 上 的 区 别 
首先 来 看 一 下 Fabric 基本 的 记述 例子 。 
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#! /usr/bin/env Python 
# -*- coding: utf-8 -*- 


Ge 人 eic 二 ii Ga 


def faptest () : 
local('mkdir -p /tmp/local test') 
run('mkdir -p /tmp/remote test') 
with lcd('/tmp/local test'): 
Tocal( DO 
with cd('/tmp/remote test'): 
run('pwd') 
Fabric 能 够 分 开 记 述 本 地 服务 名 和 远程 服务 硕 上 的 操作 。 用 local 记 
述 的 命令 在 运行 Fabric 的 本 地 服务 需 上 执行 ,用 run 记述 的 命令 在 远程 
服务 占 上 执行 。 在 移动 当前 目录 并 执行 命令 的 情况 下 ， 用 with 语句 将 
lcd 和 local， 以 及 cd 和 run 绑 定 到 一 起 来 记述 。 
下 面 是 获取 文件 并 部 署 的 例子 。 
#! /usr/bin/env Python 
# -*- Coding: utf-8 -*- 








Gin 人 eic ne 


def getputtest () : 
get ("/var/log/httpd/access.10g") 
one ese ria /ee 


Fabric 能 够 从 本 地 服务 需 回 远程 服务 融 发 送 文件 ， 反 之 也 是 可 行 的 。 
上 述 两 个 例子 展示 了 基本 的 Fabric 记述 方法 。 下 面 再 来 看 一 下 零 停 
机 时 间 发 布 用 的 fabfile.py， 发 布 作 业 目 动 化 的 例子 如 下 所 示 。 


#! /usr/bin/env Python 
# -*- coding: utf-8 -*- 











nde SV, OZ, LE , StF1Nne 
Fen ne 


def getenv (name): 和 二 取得 服务 器 的 环境 变量 
eseen ona ean: 
return os.environ[namel 


return "™" 


def deploy(): 
enemeaeneanmee hselnen, 
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build update() 
emamecenmeaeneen nel 


elemelheneenleneneenoens: 
run('/path/to/change balancer' + mode) < 切换 负载 均衡 器 的 命令 





clemoLulkemueee ree: 
wlth ea(' /eath/o/Bulld Aire/!): 
run('git checkout master && git fetch &é& git checkout -b %s %s' % 
(getenv( EREVANCGEE ) ， getenyv( AG ) ) ) 
wu ( /ae EO)/Sulle e/aalleaaelom Seereer eatese!) 





1 重启 应 用 程序 的 命令 


Fabric 可 以 直接 使 用 Python 的 写法 ， 也 可 以 使 用 shell 脚本 的 记述 
方式 ， 因 此 无 论 对 于 运 维 人 员 还 是 开发 人 员 来 说 ，Fabric 都 是 容易 上 手 
的 工具 。 上 述 例子 中 在 运行 Fabric 的 服务 磊 上 将 分 文 名 和 标签 名 分 别 设 
置 给 环境 变量 RELEASE BRANCH 和 RELEASE TAG， 在 这 样 的 状态 
下 执行 Fabric 就 能 切换 到 任意 的 版 本 。 








as Fabric 的 运行 方法 


$ fab -H 服务 器 A, 服务 器 B deploy 


Fabric 可 以 在 fabfile.py 中 目 由 地 定义 object。 这 个 例子 中 将 deploy 
作为 object 定义 并 执行 。 这 样 就 如 同 “Fabric ( 串 行 执行 ) 的 情况 ”中 
所 记述 的 内 容 一 样 ， 不 需要 停止 服务 就 可 以 进行 发 布 作业 。 上 述 例子 中 
只 涉及 了 两 侣 服务 希 ， 当 服务 需 的 台数 更 多 时 ， 如 果 仍 然 一 台 一 台地 的 
行 的 话 ， 发 布 所 花费 的 时 间 台 会 和 服务 硕 人 台数 成 比例 地 增加 。 为 了 将 发 
布 所 用 的 时 间 控 制 在 一 定 范围 内 ， 可 以 设置 Fabric 为 并 行 执行 ， 并 配置 
同时 执行 的 数量 。 

由 不 少 于 4 台 服 务 硕 运行 时 的 命令 如 下 所 示 。 用 - P 指 定 并 行 执行 ， 
用 -z 来 设置 同时 执行 的 合 数 。 


$ fab -P -z 2 服务 器 A, 服务 器 B, 服务 器 C, 服务 器 D deploy 








@ 服务 器 A， 服 务 器 B 执行 deploy 
@ 服务 器 C， 服 务 器 D 执行 deploy 
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发 布 作业 可 以 按照 上 述 顺 序 进 行 ， 如 采 有 6 人 台 服 务 套 的 话 ， 可 以 
将 - z 设 置 为 3， 将 发 布 分 为 前 半 部 分 和 后 半 部 分 。 即 使 进一步 增加 服 
务 天 人 台数， 也 可 以 用 和 两 台 服 务 融 时 相同 的 时 间 完 成 发 布 作 业 。 通 过 有 
效 运用 Fabric， 就 能 够 很 容易 地 将 我 们 从 手动 发 布 作业 中 解放 出 来 。 





6.5.4 Jenkins 





Jenkins 作为 CI 工具 来 说 非常 实用 ， 作 为 部 署 的 辅助 工具 来 说 同样 
可 以 加 以 有 效 利用 。Jenkins 通过 在 远程 服务 右上 安装 客户 端 代理 ( slave 
agent )， 可 以 在 远程 服务 大 上 执行 各 类 任务 。 








本 主 节点 ( master node ) 和 从 节点 ( slave node ) 的 协作 





Jenkins 客户 端 代理 的 安装 方法 非常 简单 。 确 保 能 够 从 主 市 点 通过 
SSH 登录 到 从 节点 ， 这 样 只 需 在 Jenkins 管理 画面 上 添加 从 节点 ， 主 节 
点 了 驶 会 问 从 布点 部 署 上 必要 的 文件 ， 并 目 动 局 动 客 户 端 代 理 〈 网 6.14 )。 
客户 端 代理 的 启动 可 以 根据 需要 设置 为 一 直 启 动 、 定 时 启动 ， 或 只 在 执 
行 任务 时 启动 等 。 


图 6.14 从 主 节点 经 由 从 节点 执行 任务 
辣 Jenkins @ 


Jenkins free style #2 


人 0 


态 状 态 集 


> 学 变更 记录 Started by tulik 

Buildin Sane el rkspace dvari lib/jenkins/workspace/samp ie-job1 
[ea mp le-job1] 3 Loin nh a p/h ds n7393648433228673233- sh 

Console Output + scp /tmp/test-file St yn _test-file 
Fi shed: SUC Es 




















过 View as plain text 
Ea 编辑 编译 信息 
© 删除 本 次 生成 
舍 前 一 次 构建 








嘟 | 到 助 我 们 本 地 化 当前 页 生成 页 面 : 2015-1-4 20:44:26 ”REST API Jenkins ver 1.590 


这 里 将 对 和 象 服务 侣 作为 三 点 、 将 部 署 相 天 的 task 作为 任务 进行 管 
理 ， 通 过 联系 各 个 事物 ， 来 构建 日 动 化 发 布 的 环境 。 和 编 配 工具 





Q) Jenkins 的 安装 方法 请 参照 5.4 节 。 
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Capistrano/Fabric 相 比 ，Jenkins 的 优势 在 于 具备 控制 台 输 出 和 用 户 管理 
功能 。 

无 论 是 为 了 能 在 Web 的 管理 画面 上 看 到 谁 、 何 时 、 执 行 了 什么 内 容 
这 样 的 记录 ， 还 是 从 留 下 跟踪 信息 的 观点 出 发 ，Jenkins 可 以 自动 实现 上 
述 功能 。 通 过 添加 Active Directory plugin" 这 款 插 件 ，Jenkins 能 够 和 
Active Directory 进行 协作 。 并 且 通 过 添加 Role Strategy Plugin 插件 ， 
Jenkins 可 以 以 任务 为 单位 进行 用 户 权 限 管 理 。 因 此 ， 即 便 是 需要 严格 进 
行 用 户 管理 的 企业 ， 也 可 以 放心 使 用 。 

通过 利用 Jenkins 的 参数 化 构建 (build ) 这 个 功能 ， 可 以 在 每 次 执 
行 任务 时 传递 shell 变量 ， 以 便 对 任务 进行 灵活 的 管理 。 

下 面 ， 我 们 以 从 远程 服务 大 上 通过 scp 命 令 发 送 文件 为 例 ， 对 从 节 
点 的 添加 、 任 务 的 设置 、 执 行 等 一 系列 流程 进行 讲解 。 




















e@…… 从 节点 的 添加 


顺利 启动 Jenkins 后 ， 通 过 浏览 右 访 问 http://${remote_ 
host}) :8080， 能够 看 到 Jenkins 管理 画面 的 初始 状态 。 该 状态 允许 文 
件 访问 ， 因 此 正式 使 用 的 情况 下 ， 建 议 通 过 添加 用 户 或 防火 墙 等 对 IP 
进行 适当 的 限制 。 

添加 从 节点 时 ， 按 照 “ 系 统管 理 ” 一 “管理 节点 ”一 “新 建 节点 ” 
这 样 的 流程 对 节点 进行 设置 。 必 须 设 置 的 项 目 有 of executors (同时 
build 数量 ) 和 远程 工作 目录 、 启 动 方 法 (图 6.15 )。 











(DD https://wiki.jenkins-ci.org/display/JENKINS/ActivetDirectory+plugin 
©) https://wiki.jenkins-ci.org/display/JENKINS/Rolet+Strategy+Plugin 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 





6.5 编 配 ( Orchestration ) | 239 
一 二 < 

图 6.15 ”节点 的 添加 

全 Jenkins 
Jenkins odes 

全 返回 名 字 slave-node1 
> 系统 管理 描述 
是 新 建 节 点 

# of executors 3 
兴 配置 

远程 工作 目录 ，Nvaribjienkins 
构建 队列 一 
标签 

队列 中 没有 构建 任务 

ee _ 村 尽 可 能 的 使 用 这 个 节点 

1 空闲 启动 方法 Launch slave agents on Unix machines via SSH 

2 空闲 

127.0.0.1 
Credentials 
rooteeeee* 了 | > ed 


Availability 


Node Properties 


| Tool Locations 








Keep this slave on-line as much as possible 


-|] Environment variables 


高 级 … 





由 远程 工作 目录 决定 部 署 客 户 病 代理 的 路 人 径 ， 如 果 该 目录 下 还 没有 


部 署 客户 端 代 理 ， 











Jenkins 会 目 动 从 主 节 点 回 对 应 的 路 径 进 行 部 署 。 在 局 


动 方 法 中 配置 启动 客户 端 代理 所 需要 的 路 径 。 

UNIX 系统 选择 Launch slave agents on Unix machines via SSH， 
Windows 机 和 带 可 以 选择 Let Jenkins control this Windows slave as a 
Windows service。 其 他 局 动 客 户 端 代 理 的 方法 还 有 JNLP ( Java Network 











Launching Protocol )， 该 方法 适用 于 主 广 点 在 防火 载 


外 ， 其 他 的 从 节点 


在 防火 墙 内 等 存在 网 络 限制 的 情况 。 
为 了 通过 SSH 局 动 客户 端 代理 ， 需 要 配置 认证 信息 ， 这 里 可 以 设置 


ID/PASS 或 密 铀 (图 6.16 )。 
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图 6.16 ”认证 信息 的 管理 
辣 Jenkins 





Jenkins Manage Credentials 


十 新 建 条 Manage Credentials 
筷 用 户 


饼 任务 历史 
Credentials not bound to a domain 
2 系统 管理 Credentials 

| Credentials Username with password 


Seope | elba Je 
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待 节 点 的 配置 完成 并 通过 认证 ， 远 程 服 务 器 上 会 启动 名 为 slave.jar 
的 进程 ， 作 为 主 市 点 的 管理 对 象 由 主 节点 控制 。 如 果 添 加 从 厄 点 出 错 ， 
有 可 能 是 因为 认证 信息 没有 正确 设置 ， 或 者 bashrc 中 记载 7 多 余 的 命令 
而 造成 了 slave.jar 启动 失败 。 











a 任务 的 添加 








添加 完 从 布点 后 ， 接 看 话 加 在 从 节点 上 执行 的 任务 。 可 以 从 Jenkins 
首页 的 “新 建 ” 开 始 添 加 。 选 择 “ 构 建 一 个 自由 风格 的 软件 项 目 ”。 
Jenkins 是 作为 CI 工具 开发 的 ， 所 以 有 构建 和 代码 管理 相关 的 配置 ， 作 
为 编 配 工具 使 用 时 可 以 直接 跳 过 这 部 分 配置 。 

在 Restrict where this project can be run 设置 刚才 添加 的 节点 ， 点 击 
“构建 ”下 的 “增加 构建 步 又 ”， 选 择 “Execute shell”， 这 样 就 能 在 远程 
服务 硕 上 执行 任意 的 命令 了 。 作 为 执行 命令 时 传递 变量 的 方法 ， 可 以 选 
中 “参数 化 构建 过 程 ”， 添 加 文本 、 字 符 串 、 单 选 框 等 输入 栏 。 可 以 设 
置 多 个 参数 ,“ 和 名字 ”一 栏 中 输入 的 文字 能 够 直接 作为 环境 变量 传递 给 脚 
本 (图 6.17)。 
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图 6.17 ”任务 的 添加 
忽 Jenkins 

























































































Jenkins sample-job1 配置 
会 返回 面板 项 目 名 称 sample-job1 
局 | 状态 描述 
导 们 沙 记 录 
二 工作 空间 
例 Buid with Parameters 
© 开除 Project [Escaped HTML] 预览 
兴 配置 丢弃 旧 的 构建 © 
Backlog 
Build History 构建 历史 一 GitHub project ©@ 
String Parameter @ 
名 字 FILENAME © 
默认 值 ©@ 
葡 述 fa og 上 二 Hu 局 
各 | 从 远程 服务 器 上 获取 文件 
© 
[Escaped HTML] 预览 > 
添加 参数 ~ 
关闭 构建 (重新 开启 构建 前 不 允许 进行 新 的 构建 ) @ 
在 必要 的 时 候 并 发 构建 © 
加 Restrict where this project can be run @ 
Label Expression | slave-node1 
Slaves in label: 1 
高 级 项 目 选 项 
高 级 .… 
源码 管理 
© None 
© cvs 
© CVS Projectset 
© Git 
2 Subversion 
构建 蛮 发 器 
Build after other projects are built @ 
Build periodically @ 
Build when a change is pushed to GitHub 
EI GitHub Pull Request Builder 
Poll SCM © 
构建 环境 
回 SSH Agent 
构建 
Execute shell @ 
Command | scp $ {FILRNAME} /tmp/$ {NODE_NAME}_$ {FILENAME##*/} 
See the list of available environment variables 
增加 构建 步骤 ~ 
构建 后 操作 
增加 构建 后 操作 步骤 ~ 
加 
帮助 我 们 本 地 化 当前 页 生成 页 画 : 2015-1-6 15:06:51 RESTAP| Jenkins ver 1.590 
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这 里 定义 名 为 FILENAME 的 字符 串 变 量 ，shell 脚本 中 的 调用 方式 
如 下 5 
scp ${FILENAME} /tmp/S{NODE NAME} S${EFRILENAMBE##*x/ } 
除了 上 述 参 数 之 外 ，Jenkins 的 任务 中 还 可 以 使 用 名 为 NODE_ 
NAME 的 变量 。 


e…… 任务 的 执行 


任务 添加 完成 后 就 是 执行 了 。 点 击 新 建 任 务 中 的 Build with 
Parameters， 会 出 现任 务 中 配置 参数 的 输入 画面 ， 输 入 远程 服务 如 上 部 
署 文件 的 路 径 (图 6.18 )。 点 击 开 始 构建 ， 就 可 以 从 远程 服务 器 上 获取 
任意 文件 。 


6.18 ”任务 的 执行 
作 Jenkins 


Jenkins sample-job1 








会 返回 面板 Project sample-job1 
这 状态 
烤 工作 空间 Dh 
经 ) Build with Parameters 

© 删除 Project 

ZK 配置 


需要 如 下 参数 用 于 构建 项 目 : 
FILENAME 


Build History 构建 历史 一 
国 RSS 全 部 且 RSS 失败 

















任务 执行 的 记录 会 留 在 “构建 历史 ”中 。 蓝 色 的 图 标 表示 成 功 ， 红 
色 的 图 标 表 示 失 败 ， 一目 了 然 。 如 果 失 败 的 话 ， 点 击 “ 构 建 历史 ”的 链 
接 ， 通 过 确认 “控制 台 输 出 ”的 shell 标准 输出 ， 就 可 以 确认 失败 的 具 
体内 容 。 

这 个 例子 中 是 通过 点 击 构建 按键 来 执行 任务 的 ， 其 他 的 任务 执行 时 
间 还 可 以 选择 Build after other projects are built ( 在 其 他 项 目的 构建 后 开 
始 构建 ) 或 Build periodically (定时 构建 )。Build periodically 能 够 以 
Cron 的 形式 安排 任务 执行 。 因 此 应 用 本 例 中 所 列举 的 scp 任意 文件 的 内 
容 ，Build periodically 能 够 实现 从 多 个 从 市 点 上 定时 收集 各 类 日 志 这 一 
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作业 的 日 动 化 。 
Jenkins 能 及 时 擎 握 哪 个 从 节点 的 日 志 收 集 处 理 失 败 等 信息 ， 对 失败 
的 处 理 还 可 以 配置 警告 ， 因 此 可 以 作为 管理 工具 加 以 有 效 利 用 。 








6.5.5 ”最 佳 实践 





@.…… 结合 Jenkins 和 Fabric 


至 此 我 们 介绍 了 几 款 编 配 相关 的 工具 。 并 不 是 说 只 要 选用 其 中 的 一 
个 就 可 以 了 ， 只 有 组 合 使 用 上 述 工 具 ， 才 能 实现 先进 的 自动 化 环境 构建 。 
笔者 所 实践 的 自动 化 部 署 环境 中 ， 用 Jenkins 管理 所 有 的 任务 ， 通 过 
SSH 登录 远程 主机 ， 执 行 shell 的 部 分 则 使 用 Fabric 来 实施 ( 图 6.19 )。 








图 6.19 ”Jenkins 和 Fabric 的 组 合 
7 - 





Jenkins 主 节 点 Jenkins 从 节点 
AH ( Fabric 的 运行 服务 器 ) 






通过 Fabric 对 远程 
服务 器 执行 shell 


PE ES ES 
2 : 国 B 2 GC ss D 


这 个 结构 的 优点 在 于 ， 通 过 Jenkins 的 从 届 点 执行 Fabric， 能 够 将 
Fabric 的 执行 结果 作为 Jenkins 的 控制 台 日 志保 存 下 来 。Fabric 添加 远程 
主机 非常 容易 ， 并 且 能 够 作为 代码 进行 管理 ， 因 此 在 版 本 管理 的 基础 上 
可 以 对 手头 的 环境 进行 验证 ， 或 者 对 各 类 环境 进行 操作 。 

通过 组 合 使 用 工具 ， 就 能 够 取长补短 ， 提 高 工作 效率 。 
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6.5.6 ”考虑 安全 问题 


seeeeeeeeeseeseeseseeeeseseseeseeseseseeeseeseeseseeseeseeeeseeseeseeeseeseoseseeeseeseeseseeseeeeeeeeseeseeseeseeoeeeeeeeeee 





推进 发 布 的 目 动 化 需要 考虑 用 root 账户 登录 SSH 并 执行 命令 ， 或 
者 以 有 权 执 行 sudo 的 用 户 进行 登录 。 但 从 安全 方面 来 说 ， 人 允许 root 登 
录 是 非常 危险 的 ， 因 此 很 多 服务 需 将 sshd_config 中 的 PermitRootLogin 
设置 为 no。 

在 这 种 情况 下 ， 可 以 设置 为 只 有 从 运行 Capistrano 或 Fabric 的 服务 
佑 发 出 的 登录 请 求 才 人 允许 PermitRootLogin， 禁 止 除 此 之 外 的 客户 端的 
root 登录 。 

通过 设置 为 具有 特定 的 用 户 〈 服 务 硕 管理 员 ) 才能 登录 到 运行 
Capistrano 或 Fabric 的 服务 硕 ， 并 采用 公 钠 验证 的 方式 ， 束 能 在 确保 安 
全 性 的 同时 构建 自由 度 较 高 的 发 布 自动 化 环境 。 具 体 地 说 就 是 ， 对 部 署 
目标 服务 大 的 /etc/ssh/sshd_config 进行 如 下 配置 。 




















RSAAUthentication yes 
PasswordAuthentication no 


PermitRootLogin no 


MaleehyAaderess Dee 二 从 OpenSSH4 .4 开始 可 以 使 用 Match 命 令 
PermitRootLogin without-password 





1 通过 设置 without-password， 介 许 密 码 认证 以 外 的 登录 方式 





sshd 中 可 以 用 Match 命令 对 条 件 分 文 进行 配置 ， 如 采 是 符合 条 件 的 
IP 地 址 或 用 户 发 出 的 SSH 连接 请 求 的 话 ， 可 以 按照 配置 的 内 容 进行 控制 。 
本 例 中 ， 假 定 运行 Capistrano 或 Fabric 服务 需 的 卫 地 址 为 192.168.1.1， 则 
仅 人 允许 上 述 服务 需 对 root 账户 发 起 RSA 认证 的 SSH 连接 请 求 。 从 安全 
性 方面 来 说 ， 需 要 在 兼顾 各 方面 的 基础 上 进行 有 效 的 设计 。 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


6.5 编 配 ( Orchestration ) | 245 


一 专栏 手动 部 署 的 例子 一 | 
至 此 我 们 介绍 了 几 款 部 署 的 目 动 化 工具 ， 但 实际 运用 中 仍然 有 
不 得 不 手动 作业 的 状况 发 生 。 


图 无 法 实现 自动 化 ， 不 得 不 手动 作业 的 情况 
需要 手动 作业 的 案例 有 下 面 这 些 。 


@ 第 一 次 构建 自动 化 环境 时 
@@ 获取 修复 故障 用 的 特殊 日 志 


全 紧急 地 重启 服务 
@@ 预料 之 外 的 情况 导致 自动 部 署 停止 时 ， 为 了 下 次 部 署 正常 运 
行 而 进行 的 修复 工作 


关于 QO ~ 合 ， 如 果 今 后 可 能 反复 发 生 的 话 ， 为 了 任何 时 候 都 能 
够 处 理 ， 建 议 为 它们 配置 自动 化 。 

@@ 的 情况 下 ， 需 要 注意 的 是 这 里 并 不 推荐 在 部 署 失败 时 强行 手 
动 对 服务 器 进行 调整 。 为 了 通过 部 署 而 强行 修改 配置 的 话 ， 就 会 导 
致 验证 环境 和 正式 环境 产生 差异 ， 那 么 下 次 部 署 时 就 很 有 可 能 再 次 
失败 。 

部 署 脚本 的 内 容 出 错 的 话 ， 应 该 修正 错误 并 再 度 实施 部 署 ， 除 
此 之 外 的 方法 这 里 都 不 认可 。@ 中 的 修复 工作 是 指 那些 在 并 非 由 于 
部 署 脚本 的 内 容 而 造成 部 署 停止 的 情况 下 进行 的 修复 工作 ， 例 如 由 
于 磁盘 空间 不 足 而 造成 部 署 失 败 时 ， 为 了 确保 剩余 空间 而 删除 一 些 
不 需要 的 文件 等 。 

我 们 不 可 能 提前 预测 到 实际 运用 中 的 各 种 情况 并 做 好 准备 。1 
服务 器 的 话 还 可 以 通过 SSH 登录 进行 操作 ， 而 要 对 多 台 服 务 器 实施 
作业 的 话 ， 就 非常 考验 耐心 和 集中 力 了 。 

针对 这 些 意外 产生 的 手动 作业 ， 也 应 该 尽 可 能 地 借助 工具 ， 考 
虑 是 否 可 以 通过 利用 工具 ， 实 现 无 论 几 台 服 务 器 都 只 需要 一 次 输入 
就 能 完成 作业 。 


2 
口 


国手 动 部 署 的 实用 工具 
表 6.a 中 列举 了 手动 作业 时 的 一 些 实用 工具 。 
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表 6.a 手动 部 署 的 实用 工具 


RLogin Windows 上 运行 的 名 为 RLogin“" 的 终端 能 够 向 所 有 打 
开 着 的 连接 同时 发 送 按 键 输入 的 操作 ， 这 样 就 能 对 所 有 
登录 状态 下 的 服务 器 同时 实施 相同 的 操作 

Tera Term 借助 常规 的 终端 软件 Tera Term 2 的 广播 命令 功能 ， 可 
以 向 多 个 终端 同时 发 送 命 令 。 感 完 只 操作 了 1 人 台 服 务 器 ， 
但 实际 上 能 够 同时 对 10 台 、 甚 至 100 台 服 务 器 进行 操 
作 ， 还 可 以 减少 操作 失误 的 可 能 性 。 需 要 注意 的 是 ， 原 
则 上 同时 向 多 个 目标 发 送 键盘 的 输入 ， 服 务 器 状态 不 一 





致 的 情况 下 可 能 会 返回 不 一 样 的 结果 。 例 如 执行 cd/usr/ 
local/tmp/ 命令 后 再 执行 touch test 的 情况 下 ，1 台 特 定 
机 器 上 的 /usr/local/tmp/ 目录 损坏 时 ，test 文件 就 会 被 

生成 在 登录 时 的 目录 下 。 因 此 ， 在 每 一 步 操 作 之 后 ， 应 
该 尽 可 能 地 确认 下 所 有 的 终端 ， 或 者 设法 通过 操作 来 吸 
收 这 种 环境 上 的 差异 





ClusterSSH/Par- | Linux 或 Mac OS 等 UNIX 系统 环境 上 有 ClusterSSH/ 
allelssh/Clusterlt | Parallelssh/Clusterlt” 等 的 OSS， 能 够 在 多 台 服 务 器 上 
同时 执行 命令 














(Dhttp://nanno.dip.jp/softlib/man/rlogin/ 并 不 是 使 用 513TCP 端口 的 工具 。 
© http:/www.vector.co.jp/soft/win95/net/se276622.html 
(3) http://sourceforge.jp/magazine/08/11/06/0025200 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


6.6 ”考虑 运用 相关 的 问题 | 247 


6.6 考虑 运用 相关 的 问题 





结合 使 用 之 前 介绍 过 的 部 署 日 动 化 相关 的 各 类 工具 就 能 够 构建 部 署 
流水 线 。 部 署 流水 线 建 成 并 进入 到 维护 的 循环 阶段 后 ， 束 可 以 在 理想 的 
时 间 ， 和 安全 地 向 正式 环境 部 署 新 的 代码 ， 这 样 束 可 以 频繁 地 对 正式 环境 
进行 部 车 了 。 这 时 需要 考虑 新 的 问题 ， 就 是 该 如 何 处 理 癌 正 式 环境 部 署 
过 程 中 发 生 的 服务 中 断 ， 以 及 由 版 本 更 新 所 引发 的 问题 。 

不 解决 这 些 问 题 就 无 法 对 正式 环境 进行 频 楷 的 部 普 ， 因 此 下 面 将 介 
绍 部 蓝 时 无 震中 上 断 服 务 的 机 制 ， 以 及 部 普 后 发 生 的 问题 的 应 对 方法 。 





6.6.1 不 中 断 服 务 的 部 署 方法 


多 数 Web 应 用 程序 在 代码 被 更 新 后 郡 需要 重启 Web 服务 。 在 请 求 
处 理 过 程 中 重启 ， 不 仅 会 造成 该 请 求 失败 ， 万 一 局 动 失败 的 话 还 有 可 能 
造成 服务 中 断 。 有 既然 部 署 作业 有 可 能 会 造成 服务 中 断 ， 那 么 在 工作 日 日 
天 进行 部 署 的 话 就 不 会 被 允许 吧 。 无 论 部 署 作业 的 目 动 化 程度 有 多 高 ， 
这 样 也 无 法 实现 频 莹 的 部 署 。 因 此 这 里 前 先 介 绍 不 会 因 部 获 造 成 服务 中 
断 的 机 制 ， 即 零 中 断 时 间 部 署 的 相关 内 容 。 




















6.6.2 ” 蓝 绿 部 署 ( blue-green deployment ) 


eeeeeeeseeeseseeseseeeseeeseeeeeseseeeee 


首先 我 们 来 看 一 下 零 中 断 时 间 部 署 方法 之 一 的 蓝 绿 部 署 (网 6.20 )。 
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发 布 过 程 中 测试 账户 被 划分 到 版 本 应 用 程 
更 新 后 的 监 环境 ， 一 般 用 户 被 划分 
到 现行 版 本 的 绿 环境 


了 H 
= 
he 





4 
测试 账户 人 一 河 训 耻 记 用 的 页 吉 罗 机 和 


/人 


负载 均衡 器 


一 般 用 户 。 绿 环境 
应 用 程序 v120 




















图 6.20 中 设置 有 负载 均衡 希 ， 后 端 有 两 全 应 用 程序 服务 天 分 担负 
载 ， 下 面 我 们 就 以 这 样 的 构造 为 例 来 讲解 零 中 断 时 间 部 署 。 应 用 程序 服 
务 俘 分 别 分 成 蓝 环 境 (blue.example.com ) 和 绿 环境 ( green.example.com )， 
负载 均衡 兹 采用 Apache 的 mod proxy balancer 模块 和 mod rewrite 模 
块 的 组 合 ， 配 置 示 例如 下 。 
# 模 块 的 加 载 以 及 mod rewrite 的 有 效 化 


LoadModule proxy module modules/mod proxy.so 





LoadModule proxy balancer module modules/mod proxy balancer.so 
LoadModule rewrite module modules/mod rewrite.so 

RewriteEngine On 

RewriteLogLevel 1 

RewriteLog logs/rewrite.1og 


# 负 载 均衡 器 的 管理 画面 用 的 URL /balancer-manager 的 配置 
<Location /balancer-manager> 

setHandler palancer manager 

Order deny,allow 

Deny' fromall 

AllGW Teom 192.168.0.0/16 
</LocationS 


# 测 试 账户 用 的 负载 均衡 组 
<Proxy balancer://test.example.com> 
BalancerMember http://blue.example.com:8080 loadfactor=50 
BalancerMember http://green.example.com:8080 loadfactor=50 
</Proxy> 
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# 一 般 用 户 用 的 负载 均衡 组 

<Proxy balancer://prod.example.com> 
BalancerMember http://blue.example.com:8080 loadfactor=50 
BalancerMember http://green.example.com:8080 loadfactor=50 


</Proxy> 


# 测 试 账户 的 配置 

# 测 试 账户 的 TIP 地址 

RewriteCond %{REMOTE ADDR} “10.8.15.1$ 

RewriteCond %{REQUEST FILENAME} !”’/balancer-manager 
RewriteRule “/(.*) balancer://test.example.com/s$1 [PBP] 


# 一 般 用 户 的 配置 
RewriteCond %{REQUEST FILENAME} ! /balancer-manadgeL 
RewriteRule “/(.*) balancer://prod.example.com/s$1 [P] 


在 浏览 硕 中 输入 http://${remote host}/balancer-manager, 
访问 采用 上 述 配 置 的 负载 均衡 右 ， 会 显示 负载 均衡 闫 的 管理 画面 (图 
6.21 )。 

图 6.21 ”负载 均衡 器 的 管理 画面 


Load Balancer Manager for loadbalancer.example.com 





Server Version: Apachey22.15 (Unbo DAW/2 
Server Built: Feb 13 2012 22:31:42 





LoadBalancer Status for balancer://test.example.com 


StickySession Timeout FailoverAttempts Method 





宇 [0 1 byrequests 

Worker URL Route RouteRedir Factor Set Status Elected To From 
http:/ /blue.example.com:8080 50 0 Ok DO D 0 
httpb. greenexamplecom:8080 50 0 Ok 0 0 0 








LoadBalancer Status for balancer://prod.example.com 


StickySession Timeout FailoverAttempts Method 


一 0 1 byrequests 
Worker URL Route RouteRedir Factor Set Status Elected To From 
1 50 0 ok 1 0 0 
50 0 Ok 1 0 DO 





Apache/22 815 (CeniOs) Server at loagbaiancer.example.com Port 30 











如 图 6.21 所 示 ， 可 以 对 发 送 至 测试 账户 的 负载 均衡 组 和 一 般 用 户 的 
负载 均衡 组 的 蓝 绿 环境 的 请 求 进行 配置 。 在 上 述 环境 下 ， 实 现 蓝 绿 部 署 
的 步 又 如 下 所 示 。 
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@ 将 balancer://test.example.com 的 green.example.com 设置 为 
Disable 

@ 将 balancer://prod.example.com 的 blue.example.com 设置 为 
Disable 

会 对 blue.example.com 实施 自动 部 署 ， 更 新 应 用 程序 

@ 从 IP 地 址 为 10.8.15.1 的 机 器 执行 测试 ( 被 划分 到 测试 用 的 负 
载 均衡 组 )， 到 下 一 个 步骤 为 止 的 时 间 段 中 ， 一般 用 户 的 请 求 被 
分 配 到 prod.example.com， 服 务 持 续 提 供 

全 通过 测试 后 ， 将 balancer:/est.example.com 的 green.example.com 
设置 为 Enable 

@@ 将 balancer://test.example.com 的 blue.example.com 设置 为 Disable 

@ 将 balancer/prod.example.com 的 blue.example.com 设置 为 Enable 

四 将 balancer://prod.example.com 的 green.example.com 设置 为 
Disable。 这 时 一 般 用 户 可 以 开始 使 用 新 版 本 的 服务 

© 对 green.example.com 实施 自动 部 署 ， 更 新 应 用 程序 

@ 从 IP 地 址 为 10.8.15.1 的 机 器 上 执行 测试 

@@ 通过 测试 后 所 有 的 负载 均衡 组 都 设置 为 Enable， 部 署 作 业 结束 








以 这 样 的 流程 进行 部 署 ， 应 用 程序 更 新 过 程 中 就 无 需 停止 服务 。 
mod proxy_balancer 的 各 个 负载 均衡 组 的 Disable 和 Enable 的 切换 可 以 
通过 HTTP 来 操作 ， 因 此 可 以 使 用 Mechanize 这 样 的 程序 来 控制 。 蓝 
绿 部 普 时 需要 注意 的 是 ， 通 稍 不 进行 发 布 时 ， 为 了 不 浪费 资 源 配 置 ， 
会 将 一 般 用 户 分 别 均 分 到 蓝 环境 和 绿 环境 ， 而 发 布 作业 时 由 于 需要 降 
级 运行 ”, 因此 要 选择 用 户 较 少 的 时 间 段 , 或 者 平时 保留 一 定 接 入 能 力 的 
见 余 。 




















6.6.3 云 (cloud ) 时 代 的 蓝 绿 部 署 





eeeeeeeeeseeeseeseeeeseeeseseeseeeseeeseeeseeeeeeeeseeeseeeeeeeeseeeee 





@ 降级 运行 是 指 在 部 分 停止 系统 的 功能 或 性 能 的 状态 下 维持 系统 运行 。 译 者 注 
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源 ， 这 个 特长 同样 能 够 运用 到 零 中 断 时 间 发 布 上 。 以 刚才 的 蓝 绿 部 普 的 
应 用 为 例 ， 可 以 采用 这 样 的 方法 : 平时 只 运行 绿 环境 这 一 套 系 统 ， 仅 在 
发 布 时 利用 Iaas 功能 制作 绿 环 境 的 镜像 ， 再 从 镜像 局 动 蓝 环 境 进行 发 布 
作业 。 只 要 能 实现 上 述 模 陈 的 发 布 ， 台 基本 上 可 以 区 服 一 般 的 蓝 绿 部 闭 
的 弱点 了 。 

发 布 时 无 需 降 级 运行 ， 平 时 也 不 需要 准备 双 份 的 服务 带 资 源 ， 就 能 
够 随时 实施 发 布 。 缺 点 在 于 知 要 增加 镜像 的 制作 、 服 务 剖 的 局 动 ， 以 及 
发 布 结束 后 删除 蓝 环 境 这 一 系列 的 工作 。 发 布 作业 变 得 复杂 ， 失 败 的 风 
险 也 随 之 上 升 。 

在 服务 融 启 动 时 采取 下 列 对 胰 能 有 效 地 降低 风险 ， 可 以 在 对 比 这 些 
对 策 的 准备 工作 所 需 的 开销 以 及 所 带 来 的 收益 的 基础 上 再 进行 探讨 。 








@ 服务 器 启动 后 用 serverspec 实施 自动 测试 
e@( AWS 的 情况 下 ) 服务 器 的 启动 操作 用 awscli 等 工具 来 实现 自动 化 
@ 平时 在 staging 环境 上 对 一 系列 部 署 的 自动 化 进行 测试 


6.6.4” 回 深 (rollback ) 相关 问题 的 考察 


@…… 随时 准备 好 退路 


无 论 事 前 进行 多 么 充分 的 测试 ， 对 正式 环境 实施 发 布 总 是 隐藏 看 发 
生意 外 的 和 危险。 比如， 用 户 使 用 了 超出 QA (品质 保证 ) 部 门 预测 的 服 
务 等 ， 进 而 造成 正式 环境 发 生 故 障 。 

也 就 是 说 ， 要 时 篆 意 识 到 发 布 时 有 可 能 将 bug 也 一 同 发 布 出 去 。 需 
要 根据 bug 的 严重 程度 ， 判 断 是 进行 回 深 还 是 在 下 次 发 布 时 修正 。 因 此 
在 进行 发 布 之 前 ， 要 准备 好 随时 回 深 的 机 制 。 反 过 来 说 就 是 ， 不 应 该 实 
施 无 法 回 深 的 发 布 作业 。 


@…… 数据 库 模 式 的 版 本 管理 
代码 的 回 深 只 需要 回 退 到 升级 前 运行 的 版 本 ,多数 情况 下 这 样 就 可 
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以 了 。 一 般 的 Web 应 用 程序 将 持久 性 数据 保存 在 RDBMS 中 。 如 果 需 要 
回 滚 数据 库 的 话 ， 可 以 使 用 数据 库 迁 移 工具 ”。 


人 回 深 的 验证 





假设 有 下 面 这 样 的 作业 流程 ， 我 们 需要 验证 在 哪个 阶段 失败 ， 以 及 
如 何 回 滚 。 


@ 显示 维护 画面 

人 Q@ 停止 应 用 程序 
@@ 更 新 源 代码 

@ 更 新 配置 文件 
四 更 新 数据 库 模 式 
@ 启动 应 用 程序 
@ 实施 冒 烟 测试 
@ 实施 性 能 测试 
© 解除 维护 画面 
@ 报告 发 布 结束 





最 理想 的 情况 是 能 够 为 所 有 阶段 的 失败 提供 自动 化 的 回 深 机 制 , 但 
这 样 会 耗费 高 郧 的 成 本 。 不 过 至 少 也 一 定 要 准备 好 确实 可 行 的 回 深 机 制 ， 
即使 是 手动 的 也 行 。 手 动 回 深 的 话 ，Rlogin 等 辅助 工具 是 非常 有 用 的 。 

下 面 我 们 来 考虑 一 下 在 两 个 比较 主要 的 回 滚 点 发 生 问题 时 的 处 理 











e…… 只 更 新 代码 的 发 布 时 的 回 滚 


例如 在 步骤 全 发 布 作业 中 断 ， 无 法 继续 进行 发 布 的 情况 下 ， 回 湾 
的 步骤 如 下 。 








@ 将 更 新 了 的 代码 回 退 到 以 前 的 版 本 
人 @ 启动 应 用 程序 


G@ 这 款 工具 在 第 3 章 中 有 详细 介绍 。 
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@ 实施 冒 烟 测试 
@@ 解除 维护 画面 
四 报告 发 布 延期 





这 是 最 简单 的 流程 ， 只 需 退 回 到 之 前 的 版 本 就 可 以 了 。 但 是 回 滚 结 
束 后 必须 用 serverspec 等 对 服务 需 进 行 测 试 ， 确 认 程 序 是 否 正 常 回 退 ， 
并 实施 冒 烟 测试 ， 确 认 应 用 程序 是 否 正 常 运行 。 














e…… 数据 库 模式 更 新 时 的 回 深 


到 冒 烟 测试 为 止 都 正常 运行 ， 在 步骤 人 @ 时 发 现 比 起 发 布 前 ,一 部 
分 功能 的 性 能 慢 了 10 倍 ， 这 样 的 情况 下 该 怎么 做 呢 ? 当然 ， 发 布 前 的 
各 种 测试 必须 对 这 类 问题 进行 覆盖 ， 但 用 测试 用 例 上 柳 关 所 有 问题 是 不 可 
能 的 。 长 期 运 俏 的 系统 会 经 常 遇 到 这 类 问题 。 

例如 ， 特 定 用 户 的 特定 项 目的 数据 量 极 闯 大 的 情 次 下 ， 或 者 是 性 质 
或 倾向 不 确定 的 多 用 户 系统 中 ， 随 着 各 类 使 用 模式 的 增加 ， 性 能 有 时 会 
发 生 退 化 。 发 生性 能 相关 问题 的 情况 下 必须 立即 进行 回 深 。 

如 有 果 没 有 上 述 步 又 加 的 话 ， 如 上 所 述 ， 只 需 回 滚 代码 就 能 解决 问 
种 。 即 便 是 能 够 立即 修复 的 问题 也 请 先行 回 深 ， 经 过 通 第 的 流程 后 再 次 
进行 发 布 。 

由 步 又 加 造成 性 能 相关 的 问题 时 ， 以 下 情况 可 以 通过 回 退 到 原来 
的 状态 ， 也 就 是 说 通过 回 深 数 据 库 模 式 来 解决 。 














e@ 系统 允许 该 数据 丢失 ( 为 了 收集 针对 新 功能 的 日 志 而 存储 的 数据 等 ) 
e 更 新 的 内 容 是 数据 迁移 或 规格 化 、 非 规格 化 等 不 会 造成 数据 丢失 
的 作业 


但 是 也 存在 下 面 这 些 无 论 如 何者 无 法 回 深 的 情况 。 


e@ 系统 不 允许 该 数据 丢失 
e@ 回 滚 时 有 可 能 产生 数据 一 致 性 问题 


这 样 的 情况 下 无 法 回 深 数 据 库 模式 。 因 此 要 预先 确 认 更 新 的 数据 库 
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栋 式 属于 上 述 哪 种 形式 。 

可 以 回 深 的 模式 没有 什么 需要 特别 担心 的 ， 只 要 使 用 迁移 工具 实施 
预 完 测试 过 的 回 深 操 作 ， 修 正 bug 后 重新 进行 发 布 即 可 。 

无 法 回 深 的 模式 虽说 并 非 完 全 没有 规避 的 方法 ,但 为 此 需要 建立 大 
规模 的 机 制 ， 非 常态 烦 。 对 于 这 样 的 高 风险 作业 ， 建 议 设置 停机 维护 时 
间 ， 在 对 用 户 影 响 较 小 的 日 期 、 时 间 实 施 发 布 。 具 体 做 法 这 里 就 不 再 详 
述 了 。 万 一 发 生 问题 的 情况 下 ， 将 风险 最 小 化 ， 并 尽早 解决 问题 ， 这 样 
的 方案 是 比较 现实 的 ， 并 且 成 本 方面 也 可 以 说 是 最 佳 的 。 

另外 ， 有 1 种 在 数据 库 模 式 更 新 后 即便 产生 bug 也 可 以 不 回 深 数据 
库 模 式 的 技术 ， 那 就 是 将 现行 的 代码 和 下 次 发 布 的 代码 都 运行 在 数据 库 
更 新 后 的 状态 下 。 

测试 时 请 确认 即使 只 更 新 数据 库 的 模式 ， 现 在 的 代码 也 可 以 通过 
测试 。 

只 要 确保 即使 先 只 更 新 数据 库 ， 程 序 也 能 够 正常 运行 ， 就 不 必 回 深 
数据 库 模 式 了 。 因 此 在 步骤 个 发 现 比 发 布 前 性 能 慢 10 倍 的 情况 下 ， 只 
需要 回 退 代码 即 可 。 

采用 这 样 的 机 制 必须 能 够 分 别 实施 代码 的 版 本 管理 和 基于 迁移 工具 
的 数据 库 的 版 本 管理 ， 并 且 可 以 使 用 Fabric 或 Capistrano 来 实现 各 个 部 
署 、 回 滚 的 目 动 化 。 
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6.7 本 章 总 结 


至 今 为 止 全 手动 部 署 的 环境 想 要 实现 全 部 日 动 化 ， 应 该 从 哪里 着 
手 ? 回答 是 “ 先 去 寻找 协助 者 和 出 资方 ”。 

部 署 的 自动 化 是 从 开发 人 员 、QA 团队 到 运 维 团 队 各 部 门 通力 协作 
的 产物 。 请 耐心 地 加 他 们 讲解 推进 部 署 目 动 化 会 融 来 哪些 好 处 ， 以 推进 
团队 齐心 协力 。 

除了 团队 的 齐心 协力 之 外 ， 新 的 环境 以 及 构建 新 环境 所 需 的 时 间 也 
是 必 不 可 少 的 。 要 问 出 资方 、 公 司 的 管理 层 讲解 部 署 上 自动 化 的 相关 内 
容 。 如 来 你 所 在 的 公司 拥有 充沛 的 资源 ， 并 且 提 供 了 类 似 于 Google 的 
“20% 规则 ”这 样 的 研究 时 间 ， 可 以 在 讲解 前 先 着 手 进行 目 动 化 所 需 的 
工作 ,通过 演示 可 运行 的 系统 来 进行 讲解 。 如 果 能 够 频繁 地 向 客户 提供 
价值 ， 对 于 大 多 数 公司 来 说 部 会 产生 好 的 影响 。 

如 果 团 队 内 部 有 不 合作 的 成 员 ， 最 初 他 们 可 能 会 党 得 麻烦 而 不 这 守 
既定 的 规则 ， 即 便 这 样 也 请 耐心 地 推进 自动 化 。 当 部 署 目 动 化 开始 逐渐 
渗透 到 整个 团队 、 整 个 公司 时 ， 它 就 成 为 必 不 可 少 的 存在 了 。 

原来 的 部 羊 需要 专门 的 知识 和 经 验 ， 如 果 部 署 的 日 动 化 开始 正常 运 
转 ， 那 么 这 样 的 知识 及 经 验 就 不 再 需要 了 。 工 作 人 员 也 可 以 通过 维护 日 
动 化 的 环境 ， 夜 间 得 以 安睡 ,市 假日 可 以 圣 受 私人 时 间 。 而 从 公司 的 角 
度 来 说 ， 对 于 能 够 让 工程 师 池 福 的 部 署 日 动 化 ， 也 没有 理由 不 实施 。 























一 专栏 PaasS 的 使 用 方式 


什么 是 PaaS 

这 里 并 不 是 要 否定 本 章 的 内 容 ， 但 构建 自动 部 署 的 环境 总 要 花 
费 相 当 的 成 本 。 当 然 通过 实现 自动 化 应 该 E 够 获得 与 其 投资 相符 合 
的 收益 ， 但 那些 因为 项 目 生命 周期 短 而 希望 投资 最 小 化 的 情况 下 ， 
或 者 是 创新 公司 希望 尽早 获得 用 户 反 馈 的 情况 下 ， 可 以 考虑 使 用 
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PaaS ( Platform as a Service )。 

PaaS 是 一 种 由 运营 商 负 责 提 供 从 网 络 、OS 到 应 用 服务 器 等 中 
间 件 的 服务 。 因 为 PaaS 能 够 立即 提供 可 使 用 的 应 用 程序 运行 环境 ， 
所 以 开发 人 员 能 够 专心 于 开发 工作 。 

PaaS 在 国内 外 有 Heroku、Force.com、Google App Engine、Cloud 
Foundry、 OpenShift、AWS Elastic Beanstalk、DotCloud、Windows 
Azure、1lJ GIOMOGOK、NIFTY Cloud C4SA 等 众多 提供 商 。 

选择 PaaS 时 要 注意 可 使 用 的 语言 及 语言 的 版 本 、 应 用 服务 器 
( Apache Tomcat/jetty 等 )、 可 使 用 的 数据 库 服务 、API 的 提供 、 可 
扩展 性 、 使 用 成 本 、 插 件 的 种 类 等 。 

以 Heroku 为 例 ， 登 录 账 户 后 从 管理 画面 上 传 应 用 程序 ， 只 
向 指定 的 远程 目录 实施 git push， 就 能 启动 Web 服务 了 。 无 需 安装 
或 调整 Apache， 只 需 在 管理 画面 增加 名 为 Dyno 的 Heroku 特有 的 
Web 服务 的 进程 数量 ， 就 能 够 处 理 大 量 的 请 求 。 开 发 人 员 只 需要 10 
分 钟 就 能 够 搭建 起 可 扩展 的 Web 服务 并 公开 。 


PaasS 的 适用 场景 


针对 这 样 的 特点 ， 这 里 介绍 几 种 有 效 的 使 用 方法 。 


@ 创新 公司 希望 尽早 公开 服务 
没有 足够 的 资源 构建 开发 环境 、 测 试 环境 、 正 式 环境 的 
情况 下 ， 不 要 直接 仅 构 建 正 式 环境 并 公开 服务 ， 而 是 利用 
PaaS 获取 用 户 的 反馈 并 反映 到 产品 中 ， 还 可 以 筹措 资金 等 。 
@ 无 法 预测 峰值 负荷 的 服务 
提供 手机 游戏 等 峰值 无 法 预测 的 服务 时 ， 可 以 利用 易于 
扩展 规模 的 PaaS。 当 服务 步 入 正轨 ， 形 成 可 预测 负 符 的 运营 
体制 后 ， 再 来 考虑 转移 到 公司 内 部 运 维 等 选项 。 
@ 生命 周期 短 的 服务 
例如 限定 期 限 为 1 个 月 的 展会 网 站 等 ， 也 可 以 使 用 
PaaS。 展 会 开始 时 收 到 大 量 请 求 的 情况 下 ， 可 以 预先 扩展 规 
模 进 行 应 对 。 展 会 结束 后 再 缩减 规模 ， 这 样 就 能 够 以 最 少 的 
成 本 维持 服务 运营 ， 客 户 解 约 的 话 也 可 以 立即 停止 服务 。 像 
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这 样 ， 无 需 负 担 多 余 的 资产 ， 非 常 适合 于 短 时 间 的 使 用 。 
@ 融入 到 企业 内 部 的 部 署 流水 线 中 
很 多 PaaS 都 可 以 使 用 全 球 公 开 的 URL， 因 此 可 用 于 营 
业 用 的 环境 ， 或 者 为 了 获取 特定 顾客 反馈 的 demo 环境 ， 这 
是 个 很 大 的 优点 。 


有 了 PaaS 就 不 需要 部 署 自 动 化 了 ? 

在 适合 利用 PaaS 的 场景 范围 内 ， 也 许可 以 说 不 需要 环境 的 配 
置 。 但 是 ，PaaS 也 并 不 是 万 能 的 。 使 用 PaaS 之 前 ， 请 仔细 考虑 
PaaS 的 下 列 缺 点 。 


@ 服务 的 使 用 量 超过 一 定 限度 后 ， 费 用 会 激增 

e@ vendor lock-in” 的 风险 

@ PaaS 的 限制 和 应 用 程序 的 特性 不 相符 的 情况 

@ 发 生 问 题 时 ， 有 时 难以 获得 调查 或 分 析 原 因 用 的 日 志 

@ 向 云 运 营 方 提出 的 监 查 要 求 可 能 不 被 接受 

e@ 想 要 的 服务 等 级 ( service level ) 和 合同 内 容 或 SLA” ( Service 
Level Agreement ) 不 相符 的 情况 

@ 存在 因 无 法 确定 问题 原因 而 难以 追究 责任 的 情况 


当 服 务 的 规模 增长 到 一 定 程度 ，Paas 的 费用 和 提供 的 服务 等 级 
开始 变 得 不 相符 ， 或 者 由 于 公司 的 规则 原本 就 和 PaaS 的 限制 不 相符 
合 等 情况 下 ， 就 很 难 继续 使 用 PaaS 了 。 在 规划 新 的 服务 时 ， 建 议 综 
合 考 虑 应 用 程序 的 特性 ， 探 讨 将 程序 部 署 到 哪里 。 并 且 结 合 定 期 发 


布 后 服务 的 增长 ， 需 要 重新 考虑 怎样 的 环境 才 是 合适 的 。 
离开 PaaS 的 时 机 


可 以 考虑 将 在 PaaS 上 公开 的 应 用 程序 移植 到 AWS ( Amazon 
Web Services ) 等 的 laaS 环境 ， 或 者 自行 运营 的 公司 内 部 环境 中 。 例 
如 ， 由 于 超过 了 预计 的 访问 量 导致 PaaS 的 使 用 成 本 变 得 无 法 接受 等 





过 度 依 赖 特 定 供应 商 的 独特 技术 进而 无 法 替换 为 其 他 供应 商 提供 的 同类 产 
译 者 注 
服务 等 级 相关 的 事前 协议 。 主 要 是 系统 正常 运行 率 相关 的 赔偿 等 内 容 。 





5 


Po 
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之 前 攻 述 的 缺点 超过 使 用 PaaS 的 优点 时 ， 就 有 必要 移植 应 用 程序 。 
那么 ， 移 植 时 必须 注意 哪些 事项 呢 ? 主要 有 以 下 3 点 。 


@ 应 用 程序 运行 环境 的 构建 
@ 数据 的 移植 
@ 服务 的 切换 


第 1 点 就 是 要 构建 新 的 应 用 程序 运行 环境 。 没 有 托管 的 服务 器 
组 或 者 自己 的 数据 中 心 的 情况 下 ， 可 以 使 用 AWS 等 的 laaS 环境 。 
构建 环境 时 可 以 一 边 参考 本 章 内 容 一 边 进行 。 

第 2 点 是 处 理 持久 性 数据 时 ， 需 要 对 数据 进行 移植 。 如 果 持 久 
性 数据 保存 在 RDBMS 中 ， 可 以 取得 Dump 数据 ( 导出 数据 )， 并 预 
先 确认 好 导入 数据 的 操作 步 又。 导入、 导出 所 耗费 的 时 间 和 切换 环 
境 时 服务 中 断 的 时 间 直 接 相关 ， 因 此 需要 事先 验证 需要 消耗 多 少时 
间 。 支 持 增 量 备 份 的 话 ， 可 以 预先 备份 好 实施 移植 之 前 的 部 分 ， 这 
样 能 够 使 服务 中 断 的 时 间 达 到 最 小 。 

第 3 点 是 服务 的 切换 。 如 果 使 用 域名 的 话 ， 可 以 预先 缩短 DNS 
记录 的 TTL ( Time To Live， 报 文 的 有 效 时 间 )， 为 能 够 在 瞬间 完成 
切换 做 好 准备 。 切 换 时 禁止 访问 旧 的 环境 ( PaaS )， 可 以 通过 显示 维 
护 了 画面 来 防止 再 向 旧 的 环境 存储 数据 。 无 法 沿用 之 前 的 URL 的 情况 
下 ， 需 要 考虑 访问 旧 环 境 时 重 定向 到 新 环境 的 调整 方式 。 移 植 期 间 
需要 保留 旧 的 环境 ， 因 此 可 以 在 确认 访问 量 的 基础 上 来 决定 关闭 旧 
环境 的 时 间 。 
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7.1 回归 测试 


至 此 ， 我 们 在 第 $ 章 讲 了 持续 集成 (Continuous Integration，CI )， 
在 第 6 章 讲 了 持续 交付 〈Continuous Delivery，CD ) 的 相关 内 容 。 本 章 
来 讲解 一 下 持续 测试 的 相关 内 容 。 


7.1.1 什么 是 回归 测试 


seeeeeseeeeseeeeseeeeseeeeeeseeeeseeseeseseeeeeeseseeeeseeseeeeseeeeeeseeeeseeeeseeeseeeeseeeseeeeseeeeseeeeee 


为 了 使 CI、CD 更 为 实用 ， 回 归 测 试 就 变 得 必 不 可 少 。 回 归 测 试 是 
以 检查 退化 为 目的 的 测试 。 虽 然 在 第 5 革 接 触 了 目 动 化 测试 , 但 那 只 是 
从 开发 人 员 视 角 出 发 的 单元 测试 。 本 章 将 更 进一步 ， 来 看 一 下 从 用 户 视 
角 出 发 的 回归 测试 ， 即 集成 测试 、 用 户 验 收 测试 的 相关 内 容 。 

一 般 来 说 这 类 测试 和 使 用 系统 的 用 户 一 样 ， 利 用 浏览 此 进行 输入 或 
页 面 迁移 ， 并 测试 是 否 得 到 所 期 待 的 结果 或 页 面 。 因 此 执行 一 个 个 测试 
用 例 的 时 间 往 往 变 得 很 长 ， 如 采 是 长 年 运 维 的 系统 ， 到 所 有 测试 执行 结 
束 为 止 耗费 大 量 时 间 的 情况 并 不 罕见 。 

事实 上 ， 在 笔者 所 在 的 公司 ,为 了 确认 前 一 天 提交 的 结 来 是 否 通 过 
回归 测试 ， 往 往 要 耗费 数 天 的 时 间 。 为 了 解决 这 个 问题 就 再 要 并 行 执行 
测试 。 

本 章 将 讲解 为 了 实现 针对 Web 服务 的 回归 测试 自动 化 所 必需 的 并 行 
测试 的 相关 工作 ， 以 及 具有 代表 性 的 用 户 验收 测试 目 动 化 工具 Selenium 
的 使 用 方法 和 一 些小 技巧 。 

并 且 ， 以 确保 产品 质量 为 主要 职责 的 工程 师 ， 往 往 并 不 擅长 编程 。 


























这 样 的 情况 下 应 该 如 何 实 现 高 效 的 日 动 化 回归 测试 呢 ?” 对 于 这 个 问题 笔 
者 也 将 给 出 目 己 的 答案 。 
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7.1.2 ”测试 分 类 的 整理 


eeoeeeeoeoeoeoeoeoeooeoeoeoeoeoeooseosoosoeoeooeoosoeososoeoeosoeoeoseoseeososoeooseososeososoeososoeoeosoeoeosseoseoeosooeooseosoeoseosoosososoeoee 








产品 开发 中 需要 根据 不 同 目 的 实施 各 种 种 类 的 测试 ， 并 且 其 数量 
之 多 ， 往 往 会 将 人 压 得 喘 不 过 气 来 。 因 此 在 进入 正题 之 前 ， 首 先 对 测 
试 这 一 概念 进行 窗 单 的 整理 。 开 发 流程 ee 
以 及 什么 种 类 的 测试 和 发 现 怎 样 的 bug 有 关 ， 了 解 上 述 内 容 是 进行 测试 
的 第 一 步 。 

测试 可 以 被 分 为 4 个 象限 "(图 7.1 )。 这 个 分 类 方法 将 各 种 测试 依据 
“业务 层面 看 到 的 ”和 “技术 层面 看 到 的 ”， 以 及 “以 文 持 团队 为 目的 进 
行 的 ”和 “以 评价 产品 为 目的 进行 的 ”的 不 同 , 用 2 根 轴 分 为 4 个 象 
限 ， 并 且 在 4 个 方块 中 给 出 了 各 类 测试 的 主要 手段 。 

下 面 对 各 象限 的 概要 进行 讲解 。 
图 7.1 ”测试 的 4 象限 


三 了 


(自动 和 手动 


功能 测试 
( 例 ) 
原型 ( Bs ) 






















探索 测试 
场景 ( scenario ) 测试 


可 用 性 测试 























故事 ( story ) 测试 。 | ”用 户 验收 测 斌 
仿真 ( simulation ) alpha/beta 测试 
第 2 象 阳 | 多 3 象 阳 


第 1 象限 | (多 4 象限 










单元 测试 安全 测试 
组 件 测试 性 能 / 负载 测试 
~ 性 ”测试 














QD) ( 美 ) Janet Gregory、Lisa Crp 著 ， 孙 伟 峰 、 鹤 康 译 《敏捷 软件 测试 : 测试 人 员 
与 敏捷 团队 的 实践 指南 》， 清 华 大 学 出 版 社 ，2010 年 。 
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e…… 支持 团队 的 技术 层面 的 测试 ( 第 1 象限 ) 


基于 单元 测试 的 测试 驱动 开发 ( Test Driven Development, TDD ) 
等 开发 中 的 主要 测试 。 主 要 是 和 内 部 品质 相关 的 内 容 ， 代 码 的 版 本 管理 
系统 、 集 成 开发 环境 ( Integrated Development Environment， 人 简称 IDE )， 
以 及 编译 自动 化 工具 等 也 属于 这 个 范畴 。 





@…… 文 持 团队 的 业务 层面 的 测试 ( 第 2 象限 ) 


与 第 1 象限 偏 技术 相对 ， 该 象限 是 更 接近 于 业务 的 顾客 观点 的 测 
试 。 除 了 功能 测试 以 外 ， 原 型 、 仿 真 、 需 求 以 及 画面 设计 每 以 推进 开发 
为 目的 的 活动 也 可 以 作为 一 种 测试 在 此 进行 。 

并 且 ， 这 里 的 测试 是 用 负责 业务 的 工作 人 员 能 够 理解 的 语言 或 格式 
来 记述 的 ， 这 些 测试 中 的 大 多 数 都 应 该 、 且 已 经 实现 了 自动 化 。 该 领域 
还 包括 借助 Fit Selenium .Cucumber Watir 以 及 Canoo WebTest 等 工 
具 的 目 动 化 测试 。 











e…… 评价 产品 的 业务 层面 的 测试 ( 第 3 象限 ) 


从 业务 的 视角 出 发 , 为 了 评价 产品 而 进行 的 测试 。 探 索 测试 ”、 可 用 
性 测试 “以 及 用 户 验 收 测试 “属于 这 个 象限 。 

基本 上 是 以 对 用 户 接 触 的 部 分 进行 测试 为 中 心 ， 相 对 于 第 1、 第 2 
象限 侧重 于 自动 化 方面 ， 这 是 只 能 由 人 手动 实施 的 测试 。 





http://fit.c2.com/ 

http://cukes.info/ 

http://watir.com/ 

http://webtest.canoo.com/ 

一 种 探索 着 进行 的 测试 。 不 是 根据 事前 准备 好 的 测试 计划 来 执行 测试 用 例 ， 而 是 
一 边 熟悉 产品 一 边 对 可 疑 之 处 进行 测试 ， 并 根据 测试 结果 随机 应 变 地 进行 下 一 步 
测试 。 

从 用 户 的 视角 来 确认 产品 的 UI ( 用 户 接 口 ) 哪里 有 问题 的 测试 。 

检验 完成 后 的 产品 是 否 满 足 需求 规约 的 测试 。 


四 昌国 昌 日 


Sa 
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@…… 使 用 技术 层面 测试 的 产品 评价 ( 第 4 象限 ) 
性 能 测试 、 安 全 性 测试 等 ， 基 本 上 不 使 用 技术 就 难以 实施 的 测试 。 
9 
针对 开发 流程 中 应 该 注重 哪些 目的 ， 或 者 说 可 以 省 略 哪 一 部 分 ， 可 
以 对 照看 测试 的 4 个 象限 来 确立 测试 方针 。 为 外 ， 为 了 确认 正在 实施 或 
者 即将 实施 的 测试 是 出 于 什么 目的 的 等 ， 也 可 以 参考 测试 的 4 个 象限 ， 
这 样 在 团队 以 及 组 织 内 容易 达成 共识 。 























7.1.3 回归 测试 的 必要 性 


eeseeseeeseeseeeeeeeeseseeeeeeseeseeseeeeseeseeseeseeeeeseeeseeeeeeeeseeseeeeeseeseeseeeseeeeeseseeeseseeeeeseeeseeeee 


@…… 退化 ( degrade ) 的 发 生 


由 于 系统 的 版 本 更 新 ， 在 之 前 的 版 本 中 正常 运行 的 功能 变 得 无 法 正 
常 运 行 ， 或 者 紧急 修正 了 某 个 问题 ,但 引发 了 其 他 新 的 问题 …… 想 必 谁 
都 经 历 过 这 种 退化 的 现象 吧 。 

虽说 如 此 ， 为 了 在 代码 变更 时 保证 质量 ， 既 然 无 法 预测 系统 的 何 处 
会 发 和 后 退化 ， 就 必须 实施 回归 测试 以 确认 没有 预想 外 的 影响 发 生 。 

并 且 ， 如 果 通 过 回归 测试 发 现 了 bug， 为 了 确认 bug 还 需要 更 进 一 
步 实 施 回归 测试 。 但 是 这 样 的 测试 流程 需要 较 多 的 时 间 ， 因 此 如 果 不 实 
现 自动 化 ， 在 实际 项 目 中 就 很 少 会 被 运用 。 














i 应 该 实现 目 动 测试 的 原因 


那么 应 该 怎么 做 呢 ? 从 修改 的 代码 确定 影响 范围 ， 再 从 重要 程度 等 
风险 的 观点 出 发 确定 测试 范围 后 实施 测试 ， 这 可 能 是 一 般 的 作法 。 但 是 
笔者 认为 通过 实现 回归 测试 的 日 动 化 ， 每 次 部 执行 所 有 的 测试 用 例 ， 能 
够 最 有 效 地 保证 质量 。 

人 为 判断 执行 哪些 测试 用 例 本 里 就 可 能 产生 失误 。 根 据 时 间 的 限制 
来 决定 可 以 执行 的 测试 范围 和 测试 量 ， 最 终 只 要 不 执行 所 有 的 测试 用 
例 ， 还 是 难免 会 担心 。 

实现 测试 的 目 动 化 还 会 市 来 其 他 的 一 些 好 处 。 正 如 我 们 在 第 5 草 中 
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说 明 的 那样 ， 每 次 提交 后 执行 测试 ， 如 果 能 够 即刻 发 现 问题 ， 那 么 问题 
就 能 外 Q 迅 速 地 解决 。 

在 提交 1 周 后 才 收 到 当时 的 修改 引发 了 新 的 问题 这 样 的 报告 ， 有 时 
怠 震 要 和 匈 回 想 一 番 后 才能 看 手 。 因 此 实现 测试 的 目 动 化 ， 频 楷 地 实施 测 
试 还 能 够 加 快 开 发 速度 。 

为 了 减少 退化 bug 要 怎么 做 才 好 呢 ? 在 此 之 前 人 们 为 了 减少 退化 
bug 进行 了 各 类 答 试 ， 得 到 的 答案 是 : 通过 人 工 测 试 来 保证 质量 ， 从 效 
率 以 及 速度 上 来 说 部 有 其 局 限 性 ， 只 有 通过 自动 测试 才 行 。 从 在 此 之 前 
的 手动 测试 转变 为 重视 日 动 测试 ， 发生 退化 的 数量 也 得 以 大 幅 减 少 (图 
72、 图 7.3) 








7.2 ”通过 自动 测试 发 现 的 bug 在 所 以 被 发 现 的 bug 中 所 占 的 比例 
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当然 自动 测试 的 效果 根据 产品 的 特性 会 有 所 变化 ， 但 不 难看 出 ， 无 
论 是 对 于 提高 产品 的 质量 还 是 顺利 推进 开发 来 说 ， 回 归 测 试 的 自动 化 都 
是 重要 的 因素 。 





7.1.4 回归 测试 目 动 化 的 目标 


说 起 实现 回归 测试 的 自动 化 ， 之 前 叙述 的 各 个 种 类 的 测试 中 哪些 应 
该 实现 自动 化 呢 ? 首先 ， 一 般 来 说 是 由 开发 人 员 实 施 的 单元 测试 。 可 是 
无 论 单 元 测试 的 覆盖 率 如 何 提升 ， 仪 靠 单元 测试 是 无 法 保证 产品 的 质量 
的 。 单 元 测试 作为 确保 程序 的 动作 和 开发 人 员 的 意图 相 一 致 的 测试 ， 即 
使 达到 100% 的 履 盖 率 ， 还 是 有 如 下 这 些 bug 无 法 发 现 。 


seeeeseeeeeeeseeeseseeeseeeseeseseeesseeseeeeeeeseeeseeseeseeseeeseeeeeseeeeeeeeeee 














e@ 在 程序 中 的 for 或 while 这样 的 循环 中 ， 不 进入 循环 体 或 者 超过 
了 最 大 循环 次 数 等 边界 值 相 关 的 bug 

e@ 包含 预料 之 外 的 数据 时 的 异常 处 理 不 充分 而 导致 的 bug 

e@ 共享 内 存 的 操作 或 数据 库 的 锁 处 理 等 ， 由 于 进程 、 线 程 间 共享 数 
据 而 在 特殊 的 时 间 点 发 生 的 bug 

e@ 使 用 了 中 间 件 的 某 个 特定 版 本 ( Web 服务 器 、 数 据 库 服 务 器 、 邮 
件 服 务 器 等 ) 而 产生 的 bug 

e@ 需求 自身 的 问题 所 造成 的 bug 

e@ 功能 未 完成 而 造成 的 bug 





多 数 系 统 会 使 用 数据 库 服 务 硕 或 缓存 服务 硕 这 样 的 中 间 件 ， 或 者 通 
过 API 调 用 其 他 Web 服务 的 资源 ， 很 多 功能 仅 有 系统 自身 无 法 运行 ， 
因此 就 需要 在 和 实际 产品 相同 的 环境 下 进行 测试 。 并 且 还 有 可 能 发 生 和 
用 户 所 使 用 的 OS 及 浏览 器 相关 的 bug。 因 而 需要 对 各 种 条 件 下 系统 的 
运行 要 求 是 否 得 到 满足 进行 测试 。 

所 以 ,不 仪 仪 是 单元 测试 ， 还 需要 从 最 终 使 用 系统 的 用 户 视 角 出 发 
的 集成 测试 。 不 过 值得 庆 壮 的 是 ， 这 种 集成 测试 的 目 动 化 工具 正在 不 断 
地 被 开发 出 来 。 下面 讲解 的 作为 Web 应 用 程序 测试 框架 的 Selenium 就 
是 一 球 车 名 的 测试 工具 。 
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7.2 Selenium 


7.2.1 什么 是 Selenium 





Selenium 是 实现 Web 应 用 程序 的 功能 测试 以 及 集成 测试 自动 化 的 
浏览 器 驱动 测试 工具 群 ， 具 备 以 Web 应 用 程序 的 测试 自动 化 为 特点 的 各 
类 功能 。 

和 使 用 系统 的 用 户 相 同 ， 在 浏览 各 上 进行 的 鼠标 操作 、 在 表单 中 输 
入 文字 或 者 打开 页 面 时 ，Selenium 能 够 检查 页 面 的 内 容 是 否 正确 显示 、 
检查 表单 的 值 以 及 验证 页 面 内 执行 的 JavaScript 等 。 因 此 借助 Selenium 
能 够 重复 实施 至 今 为 止 手动 操作 的 测试 。 





























7.2.2 Selenium 的 优点 


seeeeeeeeeeseeeeeeseseeeeeeeseeeseeeeeeseeeeeeeeseeeeseseeeeeeeseeeeeeseeseeseeeeeeeeseeeseeeeeeeeseeeeeee 





下 面 介 绍 一 下 Selenium 的 主要 特点 。 
e@…… 目 动 化 测试 用 例 制作 简单 


首先 是 测试 用 例 的 制作 非常 简单 。Selenium 提供 了 名 为 Selenium 
IDE 的 工具 。 该 工具 具备 记录 (capture ) 键盘 或 鼠标 的 操作 并 播放 
( replay ) 的 “capture* replay” 功 能 ， 能 够 非常 简单 地 制作 测试 用 例 。 

因为 能 直接 根据 浏览 硕 上 的 操作 生成 测试 用 例 ， 所 以 不 善于 编程 的 
工程 师 也 能 简单 地 制作 自动 测试 用 例 。 











@…… 文 持 多 种 浏览 器 及 OS 
其 次 是 测试 可 使 用 的 浏览 硕 种 类 多 样 。 现 在 文 持 的 浏览 锅 有 Internet 


(D http:Wwww.seleniumhq.org/ 
@ 还 有 名 为 Selenium Builder 的 Selenium IDE 的 后 续 工具 。 
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Explorer (简称 IE )、FireFox、Chrome、Safari、Opera、iPhone 标准 的 
浏览 希 〈Safari )、Android 标准 的 浏览 倚 ， 可 以 说 是 支持 了 所 有 主要 的 
浏览 大 。 并 且 还 支持 Windows、OS X、Linux 、Solaris 等 多 种 OS。 

无 论 对 功能 进行 如 何 详 尽 的 测试 ， 如 有 果 在 FireFox 上 正常 运行 ,在 
IE 上 无 法 运行 的 话 ， 这 样 是 没有 意义 的 。 因 此 Selenium 文 持 在 各 种 浏 
览 硕 上 执行 同样 的 测试 用 例 。 

在 系统 文 持 的 所 有 浏览 硕 上 手动 执行 同样 的 测试 是 一 件 非常 无 聊 旦 
肪 烦 的 工作 。 这 样 党 琐 的 作业 就 应 该 实现 目 动 化 。 








7.2.3 Selenium 的 组 件 





eeeeseeseseeeeeeseeeeseeeeseeseseeeeseeeeseseeeseeeeeeesseeeeseseeeseeeeseseeeeseeeeeeeeseeeeseeseeeeseeee 


如 上 所 述 ，Selenium 作为 自动 测试 Web 应 用 程序 的 工具 群 ， 是 由 多 
个 组 件 (工具 ) 构成 的 。 根 据 运行 方式 的 不 同 ， 所 使 用 的 组 件 也 有 所 差 
异 。 这 里 简单 地 介绍 一 下 具有 代表 性 的 Selenium IDE、Selenium Remote 
Control 和 Selenium WebDriver。 








@…… Selenium IDE 


Selenium IDE 是 Selenium 测试 用 的 IDE, 是 一 款 支 持 从 测试 用 例 的 
制作 到 执行 、 调 试 的 Firefox 的 插件 ( 图 7.4 )。 

Selenium IDE 能 够 通过 录制 浏览 部 的 操作 来 制作 测试 用 例 ， 编 辑录 
制 的 测试 用 例 时 还 文 持 目 动 补足 (autocomplete )， 因 此 非常 方便 。 并 
且 制 作 的 测试 用 例 能 够 当场 立即 执行 ， 还 能 够 通过 在 测试 用 例 中 设置 
几 点 来 确认 执行 暂停 时 的 状态 ， 可 以 说 是 高 效 地 制作 测试 用 例 必 不 可 少 
国王 只。 

没有 使 用 过 Selenium 的 人 ， 可 以 从 使 用 Selenium IDE 开始 ， 来 熟 
悉 Selenium 的 测试 用 例 。 





G http:/www.seleniumhg.org/projects/ide/ 
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图 7.4 Selenium IDE 























@@e@ Selenium IDE 2.8.0 
Base URL | http://www.baidu.com/ 再 
Tabe | Source 

Command Target Value | 
Command 了 
Target 至 Select Find 
Value 

Reference Ul-Element Rollup Info™ Clear 


























@……… Selenium Remote Control ( Selenium RC ) 


Selenium Remote Control”( 以 下 简称 Selenium RC 或 Selenium1 ) 和 
Selenium IDE 一 样 也 是 自动 测试 Web 应 用 程序 的 工具 (图 7.5 )。 但 是 ， 
不 同 于 Selenium IDE 自 坪 就 能 制作 测试 用 例 并 执行 测试 ，Selenium RC 
需要 在 运行 浏览 器 的 机 器 上 启动 名 为 Selenium Server 的 服务 器 ， 该 服 
务 硕 用 于 中 继 测 试 脚 本 〈 测 试用 例 ) 和 浏览 硕 ， 并 通过 该 服务 硕 来 执行 
测试 。 





JJ http://www.seleniumhg.org/projects/remote-control/ 
@) Selenium Server 就 是 Selenium WebDriver 发 布 之 前 的 称 为 “Selenium RC Server” 的 
中 继 服 务 器 ， 和 WebDriver 合并 成 为 Selenium2 后 开始 改名 为 “Selenium Server”。 
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图 7.5 使 用 Selenium RC 的 构造 
「 所 


操作 浏览 器 










Selenium Core 







= | 浏览 8 






为 测试 对 象 
的 应 用 程序 





测试 脚本 








去 7/ 

Selenium RC 可 以 启动 、 终 止 测试 用 的 浏览 姻 、 执 行 测试 脚本 上 的 
浏览 需 操 作 命令 等 ， 还 能 够 起 到 类 似 于 HTTP 代理 的 功能 ， 因 此 可 以 在 
Firefox 以 外 的 多 种 浏览 右上 执行 测试 。 并 且 Selenium RC 还 提供 了 各 种 
语言 “能 够 调用 的 API， 因 此 可 以 使 用 各 种 编程 语言 制作 测试 用 例 。 利 
用 编程 语言 来 制作 测试 用 例 ， 可 以 实现 循环 处 理 以 及 分 文 条 件 ， 还 可 以 
将 共通 处 理 做 成 库 ， 因 此 可 以 制作 出 更 为 高 效 的 测试 用 例 “。 














@…… Selenium WebDriver 





Selenium 是 一 款 非 常 优秀 的 测试 工具 ,但 由 于 操作 浏览 器 的 引 苟 音 


主要 可 使 用 的 语言 有 Java、Ruby、Python、Perl、PHP、.NET。 
即将 发 布 的 Selenium3 将 不 推荐 使 用 Selenium RC。 虽 然 本 书 提 到 了 较 多 关于 
Selenium RC 的 内 容 ， 但 开始 新 的 项 目 时 还 是 推荐 使 用 Selenium WebDriver。 
http:/Sseleniumphq.wordpress.cony2013/08/28/the-road-to-selenium-3/ 


SO 
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分 是 基于 JavaScript 的 ， 因 此 经 营 会 受到 浏览 各 的 安全 限制 。 随 者 Ajax 
( Asynchronous JavaScript and XML ) 的 普及 ， 越 来 越 多 的 Web 应 用 程序 
开始 使 用 JavaScript， 这 个 问题 也 变 得 越发 严重 。 

另 一 方面 ， 从 2006 年 前 后 开始 ， 为 了 解决 JavaScript 限制 的 问题 ， 
Google 的 Simon Stewart 开始 开发 名 为 WebDriver 的 项 目 (图 7.6 )， 通 
过 调用 OS 的 原生 接口 来 操作 浏览 右 。 

图 7.6 使 用 Selenium2 的 构造 


fr - 








HI 人 入口 


浏览 





作为 测试 对 象 
的 应 用 程序 





”测试 脚本 








\ bs 

WebDriver 项 目 和 Selenium 项 目 能 够 互补 ， 为 用 户 提 供 更 好 的 测试 

框架 ， 基 于 这 个 原因 ， 两 者 被 合并 在 一 起 ， 并 发 布 了 Selenium WebDriver” 

(以 下 称 为 Selenium2 )。Selenium2 发 布 后 ， 原 来 的 Selenium RC 就 被 称 
为 Seleniuml 了 。 

Selenium2 结合 了 Seleniuml 的 “ 文 持 多 种 浏览 需 ”“ 丰 寅 的 测试 摘 

述 语 言 ” 的 优点 ， 以 及 WebDriver 的 “在 JavaScript 沙 箱 〈 sandbox ) 外 




















(DD http:Wwww.seleniumhq.org/projects/webdriver/ 
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部 运行 ”“ 高 速 轻 量 且 通用 的 浏览 器 仿真 器 ”的 优点 “。 


7.2.4 测试 用 例 的 制作 和 执行 


下 面 我 们 就 来 看 一 下 如 何 制作 Selenium 的 测试 用 例 。 


eeeeeeeeseeeeseeseeeseeeseeeeeseeseeseeseeeeseseeeseeseeeseseeeeeeeeseeseeseeseeeseeeseeeeeeeee 


@.…… Selemium IDE 的 安装 和 运行 


Selenium IDE 是 Firefox 的 插件 。 用 Firefox 打开 http://www. 
seleniumhqg .org/download/， 点 击 最 新 版 本 的 链接 ， 即 可 进行 安装 。 

启动 Selenium IDE， 在 浏览 妖 上 迁移 画面 、 输 入 文字 就 可 以 直接 将 
操作 记录 为 命令 ， 只 需 几 分 钟 就 可 以 制作 好 简单 的 测试 用 例 。 接 者 执行 
测试 用 例 ， 就 可 以 检验 系统 是 否 正和 运行 。 





i Selenium 的 测试 用 例 





简单 地 说 一 下 Selenium 的 测试 用 例 。Selenium 的 测试 用 例 可 以 用 多 
种 编程 语言 来 制作 ， 这 里 说 明 的 是 用 Selenium IDE 制作 的 HTML 形式 
的 测试 用 例 。 

Selenium 的 测试 用 例 由 多 个 测试 用 例 和 测试 套件 ( test suite ) 构成 。 

测试 套件 由 多 个 测试 用 例 组 合 而 成 。 通 过 组 合成 为 测试 套件 ， 多 个 
测试 用 例 就 能 按照 指定 的 顺序 执行 ( 图 7.7 )。 


〇 具体 请 参考 http://www.seleniumhq.org/docs/01 introducing selenium.jsp#brief-history- 


of-the-selenium-project。 
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7.7 “使 用 测试 套件 的 结构 示例 


三 了 





testsiute01.html ( 测试 套件 ) 
login_successful.html ( 测试 用 例 ) 


login_failed.html ( 测试 用 例 ) 


testsiute02.html ( 测试 套件 ) 
create_user.html ( 测试 用 例 ) 


create_user_error.html ( 测试 用 例 ) 








人 J 

在 Selenium IDE 中 建立 多 个 测试 用 例 后 ， 点 击 “New Test Suite” 就 
能 建立 测试 套件 。 用 编辑 需 打 开 建 好 的 测试 套件 ， 就 可 以 看 到 连接 到 各 
个 测试 用 例 的 链接 ， 如 代码 清单 7.1 和 代码 清单 7.2 所 示 。 


代码 清单 7.1 测试 套件 的 例子 (testsuite01.html ) 


<?Xml version="1.0" encoding="UIF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD 
aM TO SEEGE] NU VMEo /nw .Or IR/ mEn i nnll-Btriet. 
geo en ee ynet ne em 
lang="en"><head><meta content="text/html; charset=UTF-8" http- 








equiv="content-type" /><title>Test Suite</title></head> 
<body> 
"al ee sm en ee aelene We see Melen ny 
class="selenium"> 
所 世 OBE eCEEE 
<td><b>login</b></td> 
</ EE 
< ene> 
EOS Meef=V1lodin Sudeeadaful ,menl"Slosin SUCCessiul</as</ tes 
/ES 
css> 
<td><a href="login failed.html">login failed</a></td> 
/EES 
</tbody> 
</ EddLEs 
</body> 
</html> 
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代码 清单 7.2 测试 用 例 的 例子 ( login_successful.html ) 


<?X 邮 件 列 表 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www. 
Wa , OEE/ LR/ Sem /DD snenml =aEeleE ,ECU 
eave ee EA een nner Wu ee Meme 
<head profile="http://selenium-ide.opengqa.org/profiles/test-case"> 
<meta http-equiv="Content-Type'" content='"text/html; charset=UTF-8" /> 
<link rel="selenium.base" href="http://example.com/" /> 
<title>login successful</title> 
</head> 
<body> 
<talleneel a ne eeseae ener > 
<thead> 
En ew eels We ee hee Sh 
</thead><tbody> 
RE 过 
<td>open</td> 
= ye 
= ee 
</ EES 
< > 
<td>waitForTextPresent</td> 
<td>ID、 请 输入 密码 < /td> 
<td></td> 
/EES 
len > 
<td>type</td> 
ee i een /ee 
asamane egE 
</ EES 
les > 
<td>type</td> 
<td>id=loginPassword</td> 
<td>admin</td> 
/ES 
< ese> 
= ee Lela 
sel el Moen ye 
<ECS</ECS 
</ EES 
< eS > 
<td>verifyTextPresent</td> 
<td>You are signed in to these accounts: </td> 
<ECE</ ECS 
/EE 
</tbody></table> 
</body> 
</html> 
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e…… 什么 是 好 的 测试 用 例 


虽说 测试 越 快 完成 越 好 ， 但 据说 “用 Selenium 测试 非常 费时 ”。 如 
果 测 试 要 耗费 几 个 小 时 的 话 ， 那 么 频繁 地 执行 测试 就 比较 困难 了 ， 只 能 
将 多 个 修改 合 在 一 起 进行 测试 ， 但 这 样 测试 失败 时 就 难以 分 析 原 因 了 。 
并 且 知 提交 数 天 后 才 发 现 有 bug， 开 发 的 节奏 也 会 受到 影响 ， 无 法 高 效 
地 进行 。 

制作 测试 用 例 、 执 行 测试 、 确 认 结 果 ， 然 后 再 制作 测试 用 例 、 执 行 
测试 、 确 认 结 果 …… 为 了 让 开发 人 员 能 够 像 这 样 频繁 地 进行 测试 ， 测 试 
再 长 也 应 该 在 30 分 钟 内 结束 。 为 了 缩短 测试 时 间 ， 在 开始 制作 测试 用 
例 时 就 需要 考虑 下 面 这 几 点 。 














e@ 单独 执行 各 个 测试 套件 也 必须 能 够 通过 测试 
e@ 1 个 测试 套件 的 执行 时 间 不 能 超过 所 预期 的 全 部 测试 的 构建 时 间 


各 个 测试 套件 必须 能 够 独立 执行 ， 依 赖 于 其 他 测试 套件 的 就 说 不 上 
是 好 的 测试 套件 。 这 是 因为 ， 如 采 测 试 套件 之 间 相 互 依赖 的 话 ， 就 必须 
按照 固定 的 顺序 执行 ， 这 样 一 来 就 难以 实现 并 行 执行 ,测试 的 时 间 也 会 
逐渐 拉 长 。 

相反 ， 如 宁 测 试 套 件 之 间 相 互 独立 ， 就 有 可 能 将 运行 所 有 测试 的 时 
间 缩 短 到 和 最 长 的 测试 套件 的 执行 时 间 相 同 。 因 此 在 制作 测试 用 例 时 要 
时 刻意 识 到 上 述 两 点 。 








和 用 Selenium Server 来 运行 测试 








Selenium IDE 在 制作 测试 用 例 方 面 是 非常 强大 的 开发 工具 ， 但 并 不 
适用 于 定期 、 持 续 地 执行 测试 用 例 。 也 就 是 说 ， 开 始 测试 时 必须 在 运行 
浏览 器 的 机 器 上 点 击 Selenium IDE 的 开始 测试 按钮 。 随 着 测试 用 例 的 逐 
渐 增 加 ， 这 样 的 测试 手段 可 以 说 将 变 得 越 来 越 不 现实 。 

为 了 解决 上 述 问题 ， 下 面 将 介绍 使 用 Selenium Server 来 执行 用 
Selenium IDE 制作 的 测试 用 例 的 方法 。 
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下 载 Selenium Server 后 , 通过 下 列 命令 运行 Selenium Server, 就 能 
够 解析 HTML 格式 的 测试 用 例 、 启 动作 为 测试 对 和 象 的 浏览 磊 、 执 行 测试 
并 输出 测试 结果 的 报告 。 


C:\>java -jar selenium-server-standalone-<version-number>.jar -htmlSuite 
We Spey 

"hnttp://example.com" '"C:\path\to\testsuite01.html" 

uere nae Ee eve Nae 


命令 的 选项 由 -htmlSuite<browser><startURL><suiteFil 
e><resultFile> 构 成 。 可 以 通过 选项 -h 来 查看 选项 列表 。 


C:\>java -jar selenium-server-standalone-<version-number>.jar -h 


来 看 一 下 上 述 命令 的 例子 中 -htmlsuite 选 项 的 相关 内 容 。 

第 1 个 参数 “*firefox” 表 示 进 行 测试 的 浏览 各 的 种 类 。 修 改 为 
“*iexplore” 的话 就 可 以 使 用 下 进行 测试 。 

第 2 个 参数 “http://example.com” 是 Base URL。 对 系统 的 多 个 不 同 
版 本 执行 相同 的 测试 用 例 的 情况 下 使 用 该 参数 。 测 试用 例 的 open 命令 
所 指定 的 URL 的 路 径 〈 相 对 路 径 ) 就 是 基于 这 个 由 Base URL 指定 的 域 
名 的 ， 并 作为 绝对 URL 来 执行 。 例 如 ， 在 有 开发 团队 A 用 的 测试 环境 
( http://a.example.com ) 和 团队 B 用 的 测试 环境 ( http://b.example.com ) 
这 样 的 情况 下 ， 可 以 使 用 这 个 参数 。 

第 3 个 参数 “Ci:\path\to\testsuite01.html” 是 测试 套件 文件 的 路 径 。 
请 指定 绝对 路 径 。 

第 4 个 参数 “Ci\path\to\results.html” 是 测试 结果 报告 的 生成 路 径 。 
同样 要 指定 绝对 路 径 。 

这 样 通过 使 用 Selenium Server， 了 就 不 必 从 Selenium IDE 手动 开始 执 
行 测试 了 ,配合 使 用 Cron ?或 Jenkins 就 能 够 定期 地 执行 测试 ,并且 还 能 
够 在 Linux 或 Mac OS 等 多 个 操作 系统 上 测试 多 种 浏览 喜 。 

至 此 ， 我 们 讲 了 使 用 Selenium IDE 制作 测试 用 例 ， 利 用 Selenium 
Server 执行 测试 的 相关 内 容 。 这 样 就 可 以 利用 Selenium 执行 持续 的 集成 
测试 了 。 

QD 可 以 从 http:Wwww.seleniumhq.org/download/ 下 载 。 
@) 自动 执行 任务 的 守护 程序 。 
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7.2.5 Selenium 的 实际 应 用 





seeeeeeeeseeseeseseeseeeseeseseeseeeeseseseseseeeeseseeseeseseeseeeseeseeseeeeeeeeeeeeeeeseee 


e@…… 测试 页 面 是 否 有 改动 


根据 系统 或 功能 所 要 求 的 品质 的 级 别 ， 存 在 不 允许 预期 以 外 的 画面 
变更 的 情况 。 男 外 有 的 公司 必须 保存 并 提交 画面 的 截图 作为 实施 测试 的 
证 据 。 这 时 就 可 以 使 用 Selenium 的 画面 截图 功能 ， 实 现 打开 画面 后 截图 
这 种 麻烦 的 作业 的 目 动 化 。 这 里 将 介绍 画面 稚 图 的 方法 ， 以 及 将 获取 的 
截图 和 以 前 的 蕉 图 进行 比较 、 测 试 的 方法 。 

Selenium 可 以 通过 “captureEntirePageScreenshot” 或 “captureEntireP 
ageScreenshotAndWait” 命 令 来 截取 当前 浏览 右 的 画面 (图 7.8 )。 纵 回 
较 长 的 画面 也 能 滚动 后 截取 下 来 。 在 保存 的 文件 名 中 输入 “C:\pathvto' 
img\capturel.png” 这 样 的 绝对 路 径 来 保存 截图 。 不 设 定 痛 景色 的 话 会 输 
出 黑色 的 背景 ， 所 以 可 以 预先 设置 好 “background=#FFFFFF” 等 。 


二 下 下 > 














<td>captureEntirePageScreenshot</td> 
<td>C:\path\to\img\capturel .png</td> 
<td>background=#FFFFFF</td> 

</ EE 


接着 说 一 下 对 保存 的 画面 截图 进行 比较 测试 的 方法 。 例 如 ， 将 系统 
版 本 1 时 截取 的 画面 和 即将 发 布 的 版 本 2 所 截取 的 画面 进行 比较 。 对 版 
本 1 和 版 本 2 执行 相同 的 Selenium 测试 用 例 ， 各 自 输 出 同名 的 截图 文 
件 ， 分 别 存放 在 C:\path\toimg\v1l 和 C:\path\to\img\v2 这 两 个 目录 下 。 

图 像 的 比较 采用 名 为 ImageMasgick' 的 图 像 处 理 软件 来 进行 。 安 装 
ImageMagick 后 执行 下 列 命令 。 可 以 利用 本 书 提 供 的 脚本 “来 比较 目录 
下 的 所 有 图 像 ， 并 以 HTML 文件 的 形式 输出 结 


C:\>composite.exe -compose difference C:\path\to\img\vili\capturel .png 








Cane um eu one ea me Ene 


(D http://www.imagemagick.org/ 
(2 ”ImageMagick 的 下 载 地 址 为 http:/www.imagemagick.org/script/binary-releases.php。 
(3) 打开 http:/www.ituring.com.cn/book/1495， 点 击 “ 随 书 下 载 ”。 
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可 以 通过 高 光 的 图 像 来 确认 比较 结果 中 存在 差异 的 部 分 (图 7.9 )。 


过 比较 画面 玲 图 的 方法 ， 
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能 够 发 现 测 试 工程 师 无 论 如 何 测试 都 无 法 发 
现 的 问题 ， 请 一 定 要 试 一 下 。 


尊重 版 权 


278 | 第 7 章 回归 测试 


7.9 ”附录 脚本 的 执行 结果 文件 





Test suite results 


image-diftr 






diff-test1.png| LI[R| 99.3 

diff-test2.png 4 Same 100.0 
diff-test3.png 站 Same 100.0 
diff-test4.png 100.0 


diff-test5.png 








i 使 Selenium 测试 稳定 运行 





Selenium 的 自动 测试 并 不 是 很 稳定 。 经 常 听 说 系统 明明 正常 运行 ， 
测试 却 失败 了 这 样 的 事情 。 例 如 ， 点 击 链 接 ， 在 画面 加 载 完 成 前 挂 起 下 
一 步 操 作 的 cl1ickAndWait 命令 执行 时 ， 点 击 链接 迁移 到 下 一 个 页 面 
并 试图 点 击 页 面 内 的 按钮 ， 但 无 法 找到 该 按钮 而 造成 测试 失败 。 

上 述 情 况 下 ， 因 为 clickAndWait 命 令 执行 成 功 ， 所 以 下 一 个 页 
面 应 该 已 经 加 载 完 成 了 ， 那 为 什么 无 法 点 击 本 应 正常 显示 的 按钮 而 测试 
失败 了 呢 ? 能 够 想到 的 原因 有 服务 需 内 部 的 数据 备份 或 执行 的 测试 造成 
服务 器 的 负载 变 高 ， 对 浏览 器 的 响应 速度 变 慢 等 。 

但 其 实测 试 失 败 的 本 质问 题 在 于 服务 器 的 响应 速度 慢 ， 在 页 面 内 容 
还 没有 加 载 完毕 的 状态 下 Selenium 就 执行 了 下 一 条 命令 ， 从 而 导致 测试 
失败 。 刚 才 的 例子 中 ，Selenium 虽然 用 clickaAndWait 命 令 等 待 画面 
加 载 ， 但 没有 等 待 该 画面 中 接着 要 点 击 的 按钮 加 载 完毕 就 直接 执行 了 下 
一 条 命令 ， 所 以 造成 了 测试 失败 。 

作为 Selenium 的 创始 人 、 公 司 的 CTO，Sauce Labs 在 博客 中 这 样 
叙述 。 
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"Selenium tests often fail because they re too fast. Where a user 
might wait for a page to load for a few seconds and then click on a 
link, Selenium will interact with a page at the speed of code, before the 
page is ready.”Selenium 的 测试 经 常会 因为 速度 过 快 而 造成 失败 。 
人 为 操作 的 话 会 等 待 画 面 显 示 后 再 点 击 链 接 ，Selenium 则 是 在 画 
面 完全 显示 之 前 以 执行 程序 的 速度 实施 测试 的 。 

一 一 Howto Lose Races and Win at Selenium ( http://sauceio.com/index.php/2011/04/ 


how-to-lose-races-and-win-at-selenium/ ) 





通 第 ， 人 为 操作 浏览 右 时 会 等 等 按钮 显示 或 页 面 加 载 完 后 再 进行 之 
后 的 操作 ， 而 Selenium 则 是 直接 继续 之 后 的 操作 。 

该 如 何 解 决 这 个 问题 呢 ? 解决 方法 之 一 就 是 在 使 用 clickandwait 
命令 等 进行 画面 迁移 之 后 ， 和 暂停 (pause ) 固定 数秒 钟 的 时 间 ， 通 过 延迟 
执行 下 一 条 命令 ， 多 少 能 够 所 有 改善 。 但 这 个 方法 为 了 解决 偶尔 发 生 的 
问题 不 得 不 在 测试 用 例 的 各 处 插入 pause 命 令 ， 会 造成 测试 执行 时 间 
变 长 ， 因 此 并 不 推荐 。 作 为 其 他 的 解决 方案 ， 上 述 微 博 中 还 提 到 了 下 面 
的 内 容 。 























“The way to fix this is to have Selenium repeat its actions and 
assertions until they work. Jf you don’t, Selenium races your browser.” 
为 了 解决 这 个 问题 ，Selenium 在 得 到 正确 的 结果 前 必须 重复 动作 
或 断言 (assertions ) 处 理 ， 不 这 样 的 话 Selenium 就 会 和 浏览 器 的 
画面 显示 速度 持续 竞争 。 


How to Lose Races and Win at Selenium ( http://sauceio.com/index.php/2011/04/ 





how-to-lose-races-and-win-at-seleniumy ) 











即 命令 执行 失败 时 ， 重复 执 行 该 命令 多 次 ， 下 到 正常 运行 为 止 。 

但 是 用 通过 Selenium IDE 做 成 的 HTML 形式 的 测试 用 例 进 行 测试 
的 情况 下 ， 是 由 Selenium Server 来 解析 测试 用 例 并 操作 浏览 锅 的 ， 因 此 
不 修改 Selenium Server 的 代码 就 无 法 实现 “重复 数 次 执行 该 命令 直到 正 
常 运行 为 止 "。 背 要 重复 地 实施 处 理 ， 就 需要 通过 编程 语言 ( Java、 
Ruby、Python、Perl ) 来 制作 测试 用 例 ， 自 己 添加 重复 处 理 。 

下 面 介 绍 在 用 Selenium IDE 制作 测试 用 例 的 情况 下 ， 应 该 如 何 加 入 
重复 处 理 。 按 照 下 述 步骤 就 可 以 修改 从 Selenium IDE 导出 的 测试 脚本 中 
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的 任意 一 不 条 命 命令 。 


@ 打开 Selenium IDE 的 “Option” 一 “Option...” 一 “Formats” 
标签 

四 选择 作为 例子 所 使 用 的 格式 ( Java/JUnit4/RemoteControl 等 )， 
点 击 Source 按键 ， 复 制 所 显示 的 代码 

全 点 击 Add 按键 ， 将 步骤 2 复制 的 代码 粘贴 上 去 ， 对 需要 修改 的 
地 方 进 行 修改 

@ 输入 格式 名 称 并 保存 

加 重启 Selenium IDE 和 Firefox 

@ 以 步骤 4 做 成 的 格式 导出 测试 用 例 


将 代码 清单 7.3 修改 为 代码 清单 7.4 那样 ， 就 可 以 反复 执行 确认 男 
面 中 的 文字 内 容 是 否 显示 的 verifyTextPresent 合 令 。 








代码 清单 7.3 ”修改 前 的 代码 


function verifyTrue (expression) { 
return "verifyTrue(" + expression.toString() + "™);"; 


} 


代码 清单 7.4 ”修改 后 的 代码 


function verifyTrue (expression) { 


return "for (int second = 0;; Second++) Ra 十 
Nene seeond =600Eann( emeone TO 于 
"\ttry { " + (expression.setup ? expression.setup() + " " : "") + 
"if (assertTrue(" + expression.toString() + ")) break; } catch 


(Exception e) {}\n" + 
"trhreadsleepl(1000); Nn 
Ti NE ; 





这 样 就 能 导出 如 代码 清单 7.5 所 示 的 测试 脚本 。 在 该 测试 脚本 中 ， 
即使 画面 没有 显示 要 确认 的 文字 而 造成 assertTrue 失败 ， 经 过 一 定时 间 
后 还 会 重新 尝试 确认 。 

代码 清单 7.5 ”导出 后 的 测试 用 例 


EGR (in ee 0 een | 
es ee 0 ian me 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


7.2 Selenium | 281 


Erp 

if (assertTrue (selenium.isTextPresent ("请 输入 ID、 密 码 "))) break; 
} catch (Exception e) {} 
Thread.sleep(1000); 


不 要 直接 使 用 Selenium IDE 制作 的 测试 用 例 或 以 某 种 格式 导出 的 测 
试 脚本 ,根据 测试 脚本 的 制作 方法 的 不 同 ,确实 能 够 减少 由 于 页 面 加 载 
时 间 所 造成 的 测试 失败 。 
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7.3 Jenkins 和 Selenium 的 协作 


使 用 Selenium 进行 测试 ， 测 试用 例 的 制作 会 大 大 加 快 。 但 是 随 着 测 
试用 例 的 增加 ， 把 握 测试 是 否 被 正确 执行 、 测 试 是 否 通过 ， 也 将 变 得 非 
种 及 烦 。 

对 于 这 样 的 问题 ， 第 5 章 中 所 介绍 的 Jenkins 这 样 的 CI 工具 就 非常 
有 用 。CI 工具 可 以 实现 测试 的 实施 以 及 结果 的 品质 状况 可 视 化 ， 并 帮助 
团队 间 共 享 信息 。 











7.3.1 关联 Jenkins 和 Selenium 的 步骤 





eeeeeeeeeeeseeeseeeeseeeeseeeseeeeeeeeeeseeeeeee 


下 面 将 介绍 由 Jenkins 执行 Selenium 测试 用 例 的 方法 。 

用 Selenium IDE 制作 Selenium 的 测试 用 例 并 保存 为 HTML 格式 的 
话 ， 通 过 使 用 Jenkins 的 “Seleniumhq Plugin”， 从 Jenkins 执行 HTML 
测试 用 例 时 的 任务 设置 、 测 试 结果 报告 的 设置 都 将 变 得 非常 简单 。 

我 们 一 起 来 看 一 下 使 用 “Seleniumhq Plugin” 的 配置 方法 、 测 试 执 
行 以 及 测试 结果 的 确认 。 这 里 以 在 运行 有 Jenkins 的 机 器 上 执行 
Selenium 测试 为 前 提 进 行 讲解 。 














和 @@ 在 执行 测试 的 机 器 上 ， 从 版 本 管理 系统 下 载 测 试 套件 和 测试 
用 例 ” 

@ 在 执行 测试 的 机 器 上 下 载 Selenium Server 

四 从 Jenkins 的 “系统 管理 ”一 “管理 插件 ”安装 “Seleniumhq 
Plugin”™ 


QD 请 参考 5.4 节 中 “下 载 代码 ”部 分 的 内 容 。 
@) ”Selenium Server 的 下 载 用 Chef 来 实现 ， 请 参考 第 6 章 。 
3) https://wiki.jenkins-ci.org/display/JENKINS/Seleniumhq+Plugin 
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@ 在 Jenkins 的 “系统 管理 ”一 “系统 设置 ”中 设置 “Selenium 
Remote Control” 下 的 “htmlSuite Runner”( 图 7.10) 
设置 为 步骤 人 中 下 载 的 Selenium Server 的 路 径 


图 7.10 Selenium Server 的 设置 画面 





Selenium Remote Control 





htmlsuite Runner Cselenium\selenium-server.jar 








selenlum-server.jar Path 
@ 新 建 测试 用 的 Jenkins 任务 ,任务 的 “配置 ”如 下 
四 -1 在 “构建 ”下 的 “增加 构建 步 又 ”中 选择 “SeleniumHQ htmlSuite 
Run”， 按 照 表 7.1 进行 设置 (图 7.11) 





表 7.1 SeleniumHQ htmlSuite Run 的 设置 
项 目 说 明 





browser 设置 执行 测试 的 浏览 器 ( Firefox 的 话 是 *firefox ) 
startURL 浏览 器 启动 时 打开 的 URL 








suiteFile 设置 步骤 @@ 中 准备 的 测试 套件 
resultFile 设置 测试 结果 的 输出 文件 名 ( ex.results.html ) 








7.11 ”Selenium 测试 任务 的 配置 画面 


构建 





SeleniumHQ htmlSuite Run 
browser 





*firefox 





startURL http://example.com 





suiteFile |C:\testcase\testsuite01.html 





resultFile |results.html 








other 


图 图 图 图 图 


前 除 | 


全 -2 选择 “构建 后 操作 ”下 “增加 构建 后 操作 步骤 ”中 的 “Publish 
Selenium Report”， 按 照 表 7.2 进行 设置 (图 7.12 ) 











表 7.2 构建 后 的 处 理 
项 目 说 明 
Test report HTMLs “| 指定 报告 的 保存 格式 ( ex.*.html ) 
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图 7.12 Selenium 测试 结果 的 设 定 画面 





构建 后 操作 


:3 Publish Selenium Report 2 


Test report HTMLs |*.html | 


Flleset '|mcludes setting that speclfles the generated raw HTML report flles, such as 
'myprolect/target/test-reports/ *.html'. Basedlr of the flleset ls the workspace root,. 


高 级 


@@ -3 选择 “构建 后 操作 ”下 “增加 构建 后 操作 步骤 ”中 的 
“Archive the artifacts”， 按 照 表 7.3 进行 设置 (图 7.13 ) 














表 7.3 ”构建 后 的 处 理 
项 目 说 明 








用 于 存档 的 文件 指定 保存 文件 的 格式 ( ex.*.html ) 


图 7.13 ”Selenium 测试 结果 的 保存 画面 





3 Archive the avtifacts [2 


用 于 存档 的 文人 |*.html 本 2 


删除 





























配置 完成 后 ， 试 着 执行 Jenkins 的 任务 下 的 “立即 构建 *"。 配 置 正确 
的 话 会 启动 Firefox 并 开始 测试 ，Selenium 测试 最 后 会 输出 测试 结果 报 
告 (图 7.14 )。 

当然 也 可 以 通过 Jenkins 确认 测试 的 结果 ， 试 着 从 Jenkins 任务 画面 
左 侧 的 Build History 打开 本 次 执行 的 链接 。 构 建 #8 前 面 的 〇 的 颜色 是 
蓝 色 的 话 表 示 构 建成 功 ， 奉 是 红色 则 表示 构建 失败 ( 图 7.15 )。 
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图 7.14 ”Selenium 测试 执行 过 程 中 的 画面 





Tast Suite Mosleres 
tetteasnl dr | btp: /ve ber cra hoc) i 


bedtense Lk 
时 ss 


Tost Sulte Current Tewt Control Parel 








和 并 |n lu mi 

二 

Far more nfomation Gn Solenlam, visit 
| 


; ps, 








Dram A ase 
Mvigastion pris Bre Dire rberp=t0 i rap per | cc | Fef rt 川 arpecram | 
a 已 
Fy Selenlurm Docurrertstion 
Hid Iran 
Pst bo Hae SET 上 na dei i Ly Prt i hn ee Mer Fer le aT 下 全 
Brevi Fer spi 2 里 Lr Tat 
Te ter a Peer Wi A los 
Deenats be Sleedum 8 
全 Nabi er Mat dn Meise 
m= FP aia 人 IE Sciuem 





图 7.15 ”Jenkins 的 构建 结果 画面 






» SampleSeleniumjob 》 姑 B 


J “@ 构建 #8 (2013/11/17 16:56:12) 


Be Ba 


[本 
nm 
a 
= | 
- 
mn 





Hl 
郑 





Console Output 





构建 结果 
四 results.html ”2.53 KB 纪 参照 




















删除 本 次 生成 


Selenium Report Es 没有 变化 


二 
一 次 构建 
2 由 匿名 用 户 触发 

















使 国 析 风 国 风气 申 
EE 
具 


性 


numTestPasses: 2, numTestFailures: 0 








可 以 从 “构建 结果 ”来 确认 Selenium 的 执行 结果 ( 图 7.16 )。 测 试 
失败 时 可 以 从 这 个 Selenium 的 执行 结果 或 “Console Output” 查 看 失败 
的 原因 。 
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图 7.16 Jenkins 的 Selenium 测试 结果 画面 


Test suite results 





result: 

totalTime: 
numTestTotal: 
numTestPasses: 
numTestFailures: 
numctommandPasses: 
numCommandFailures: 
numcCommandErrors: 
Selenium Version: 
selenium Revision.: 
Test Suite 

testcasel 

testcaser 

testcasel .html 
testcasel 

open http://Wa .seleniumhg.org 
testcase2,.html 

testcase2 

open http//waww.seleniumhg.org/docs/ 


8 
上 
世 
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7.4 Selenium 测试 的 高 速 化 


之 前 已 经 多 次 提 到 ，Selenium 的 测试 中 经 常会 出 问题 的 就 是 测试 的 
速度 。Selenium 的 测试 是 从 使 用 浏览 硕 的 系统 用 户 的 观点 出 发 的 集成 测 
试 ， 加 上 Selenium 上 自身 的 速度 并 不 快 ， 因 此 和 单元 测试 相 比 的 确 是 非常 
耗费 时 间 的 测试 。 

另外 ,在 用 Selenium IDE 制作 测试 用 例 的 情况 下 ， 因 为 非常 简单 ， 
所 以 往往 容易 不 加 思索 地 对 各 处 进行 测试 ， 结 果 就 导致 执行 所 有 的 测试 
需要 耗费 大 量 的 时 间 。 

下 面 是 笔者 所 在 公司 的 Selenium 测试 套件 数量 的 演变 图 ( 图 7.17 ) 
和 所 有 测试 套件 执行 时 间 的 演变 图 (图 7.18 )。 随 着 自动 测试 的 不 断 增 
加 ， 执 行 所 有 测试 甚至 要 花费 数 日 之 久 。 


7.17 ”Selenium 测试 套件 数量 的 演变 
人 
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7.18 ”Selenium 测试 执行 时 间 的 演变 
| 、 
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一 自动 测试 的 强化 











作为 上 述 问题 的 有 效 解决 方案 ， 本 克 将 介绍 并 行 执行 测试 的 方法 。 


7.4.1 利用 Jenkins 的 分 布 式 构建 实现 测试 的 并 行 执 行 


首 完 ， 正 如 之 前 在 “好 的 测试 用 例 ” 一 市 中 所 讲 的 那样 ， 开 始 并 行 
执行 测试 时 ， 各 个 测试 套件 必须 不 相互 依赖 ， 能 够 单独 通过 测试 。 在 此 
基础 上 再 利用 Jenkins， 即 可 构建 并 行 执行 的 机 制 。 

Jenkins 提供 了“ 分布 式 构建 ”这 一 功能 强大 的 机 制 来 支持 并 行 测 
试 。 这 里 对 基于 上 述 机 制 的 并 行 执行 进行 讲解 。 

















@…… Jenkins 的 分 布 式 构建 的 构成 


利用 Jenkins 的 “分 布 式 构建 ”机 制 能 够 组 建 从 数 十 台 到 数 百 台 机 
需 的 集群 (图 7.19 )。 
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图 7.19 ”Jenkins 的 主 ( master ) 和 从 ( slave ) 结构 
六 

















各 台 机 各 根据 功能 的 不 同 分 为 master 和 slave 两 种 。 安 疾 有 Jenkins 
的 机 需 作 为 master 负责 各 种 配置 信息 的 管理 、 构 建 时 处 理 流程 的 控制 ， 
以 及 调度 各 slave 实施 处 理 等 。 

slave 从 master 接收 指令 ， 从 版 本 管理 系统 上 取得 、 更 新 代码 或 测 
试用 例 并 执行 测试 。 








@…… 分 布 式 构建 的 配置 


接着 就 让 我 们 试 着 实际 构建 一 下 Jenkins 的 master 和 slave 架构 。 这 
里 以 Windows 平台 为 例 讲解 slave 的 架构 。 


@ 配置 slave 机 器 的 Jenkins 
从 Jenkins 的 “系统 管理 ”一 “管理 节点 ”一 “新 建 节 点 ”开始 
新 建 slave 节点 (图 7.20 )。slave 的 种 类 选择 “Dumb Slave”。 其 他 项 
目的 设置 如 表 7.4 所 示 。 
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图 7.20 配置 slave 机 器 的 Jenkins 





全 Jenkins 
Jenkins nodes slave-node1 
会 返回 列表 Name selenium-client1 @ 
愉 \ 状态 描述 © 
(9 删除 子 节点 
of executors | 3 5 

淡 配置 从 节点 © 
辟 构建 历史 远程 工作 目录 | cenkins © 
负载 统计 标签 windows 加 
国 由 本 命 人 行 

用 法 4 可 
秽 起 尽 可 能 的 使 用 这 个 节点 -|e 

启动 方法 Launch slave agents via Java Web Start 了 | 加 

构建 执行 状态 一 
高 级 .… 
AR 了 | © 
Node Properties 
|] Environment variables 
-| Tool Locations 








表 7.4 slave 的 设置 


Name 设置 slave 节点 的 名 称 。 以 slave 的 计算 机 名 来 命名 简洁 易 懂 
描述 设置 节点 的 描述 


of executors | 设置 slave 机 器 上 能 够 同时 构建 的 任务 数量 。 可 以 先 设置 为 3 或 5， 
确认 执行 测试 时 的 负载 后 再 进行 调整 

远程 工作 目录 | slave 机 器 上 Jenkins 的 根 目录 。 可 以 设置 为 cNenkins 等 

可 以 为 各 slave 机 器 标注 标签 。 输 入 例如 “windows” 这 样 提 示 
slave 特征 的 标签 

指定 构建 的 调度 方法 。 设 置 为 默认 的 “ 尽 可 能 使 用 这 个 节点 








启动 方法 选择 “Launch slave agents via Java Web Start” 


Availability 指定 slave 的 可 用 性 。 设 置 为 默认 的 “Keep this slave on-line as 
much as possible 








@@ master 和 slave 的 连接 
从 新 添加 的 Windows 市 点 的 浏览 右 打 开 Jenkins， 点 击 步骤 人 @ 中 建 
立 的 slave 画面 上 的 “Launch” 刍 ， 就 能 下 载 JNLP 文件 。 运 行 该 
JNLP 文件 ， 就 会 安 猴 作为 slave 广 点 所 种 要 的 文件 ， 并 连接 master。 
Windows 会 因为 Windows update 而 频繁 地 重启 ， 因 此 要 进行 如 下 设置 。 
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e@ 将 下 载 的 JNLP 文件 存放 到 启动 目录 下 
@ 设置 为 自动 登录 


全 配置 测试 任务 在 哪个 slave 上 执行 

在 各 任务 配置 的 “Restrict where this project can be run” (图 7.21 ) 
中 指定 让 哪个 slave 来 执行 构建 处 理 。 这 里 可 以 填 和 信步 又 人 中 设置 的 
slave 节点 名 、slave 的 标签 ， 或 者 标签 和 逻辑 运算 符 〈 信 及 或 | 等) 
的 组 合 ， 由 符合 这 里 设 定 的 限制 条 件 的 slave 世 点 之 一 来 执行 构建 处 
理 。 可 以 直接 在 “Restrict where this project can be run” 设 置 slave 节点 
名 ， 但 这 并 不 是 聪明 的 方法 ， 因 为 随 着 测试 任务 的 增加 ， 特 定 slave 的 
负担 加 重 ， 即 使 构建 了 分 布 式 的 环境 ， 但 因为 限制 了 特定 的 slave， 也 
会 造成 无 法 顺利 均衡 负载 。 因 此 理想 的 方法 是 使 用 slave 的 标签 。 

















图 7.21 ”配置 测试 任务 在 哪个 slave 上 执行 





图 Restrict where this project can be run 地 


一 Ar 
标签 











@ 执行 构建 
点 击 Jenkins 任务 的 “立即 构建 ”就 会 启动 slave 机 需 执 行 测 试 。 


这 样 分 布 式 构建 环境 的 构筑 就 完成 了 。 


7.4.2 ”Selenium 测试 并 行 化 中 的 难点 


至 此 ， 我 们 讲解 了 为 了 尽快 完成 测试 ， 实 现 Selenium 测试 的 高 速 
化 ,测试 用例 应 该 符合 哪些 条 件 ， 以 及 并 行 执行 多 个 测试 用 例 的 方法 。 

这 里 再 介绍 一 下 笔者 所 在 公司 并 行 执行 测试 时 所 发 生 的 问题 。 虽 然 
在 多 数 系统 上 该 问题 未 必 会 发 生 ， 但 可 以 为 解决 推进 Selenium 测试 并 行 
化 过 程 中 的 奉 干 问题 提供 一 些 启 示 。 

在 之 前 的 “使 Selenium 测试 稳定 运行 ”这 一 小 节 中 ， 我 们 介绍 了 
Selenium 会 无 视 当 前 页 面 内 容 是 否 加 载 完 成 ， 而 直接 继续 下 面 的 测试 ， 
因而 造成 了 系统 虽然 正常 运行 但 测试 依然 失败 的 情况 。 造 成 这 种 现象 的 
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原因 可 能 是 服务 硕 正 在 备份 或 解析 日 志 等 而 造成 服务 器 的 负载 变 高 。 

同样 ， 并 行 执行 测试 也 会 引发 新 的 问题 ， 那 就 是 并 行 执行 会 启动 多 
个 浏览 锅 ， 这 些 浏览 吉 的 请 求 会 集中 发 往 特定 的 服务 硕 ， 这 样 该 服务 需 
的 啊 应 就 会 变 得 缓慢 。 

根据 上 述 方法 并 行 执行 Selenium 测试 的 情况 下 ，Jenkins 任务 中 指 
定 的 slave 或 标签 承 是 会 局 动 浏览 硕 的 机 硕 。 上 述 方法 可 以 实现 运行 浏 
览 需 的 机 需 的 负载 均衡 ， 但 无 法 实现 从 浏览 需 接 收 请 求 的 服务 需 的 负载 
均衡 (图 7.22 )。 


图 7.22  ” Selenium 测试 并 行 执行 时 的 请 求 不 均衡 



































一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 FF 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 






应 用 程序 
( 服务 器 端 2 ) 


应 用 程序 
( 服务 器 端 3) 








i i st i i i i i i ,ed i 





这 个 问题 虽 不 会 造成 测试 失败 频 楷 发 生 ， 但 在 运行 系统 的 服务 从 配 
置 较 低 或 系统 的 处 理 能 力 较 差 等 情况 下 就 很 容易 造成 这 样 的 问题 。 

对 于 上 述 问 题 ， 我 们 采取 的 对 策 是 将 浏览 瘟 客 户 端 和 运行 系统 的 服 
务 带 进行 1: 1 配对 (图 7.23 )， 包 括 应 用 程序 用 到 的 服务 融 闪 的 缓存 服 
务 天 以 及 数据 库 服务 角 等 ， 都 和 训 览 融 客户 闪 组 成 1 个 配对 ， 通 过 增加 
训 览 融 客 户 端 和 服务 胡 冰 的 配对 形式 来 扩展 测试 的 规模 。 

要 使 浏览 器 客户 端 和 服务 器 进行 1 : 1 的 配对 ， 就 需要 蔡 换 各 个 机 器 
上 的 hosts 文件 ， 使 其 向 特定 的 机 右 发 送 请 求 ( 图 7.24 )。 例如， 替换 浏览 
俘 客 户 端 机 俘 上 的 hosts 文件 ， 使 其 向 对 应 的 应 用 程序 服务 右 发 送 请 求 。 

这 样 特定 机 需 上 运行 的 浏览 融 的 请 求 就 会 发 往 特 定 的 服务 天 进行 处 
理 。 服 务 如 端 也 一 样 ， 固 定 服务 各 上 运行 的 应 用 程序 会 使 用 其 对 应 的 数 
据 库 服务 做。 
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图 7.23 1:1 的 浏览 器 客户 端 和 服务 器 的 结构 
la 2 





应 用 程序 


( 服务 器 妆 1 ) 


| ”应 用 程序 
( 服务 器 端 2 ) 


| 。 应 用 程序 
| ( 服务 器 端 3 ) 














图 7.24 ”hosts 文件 的 修改 





三 了 
Ab 客户 端 A 的 hosts 文件 
192.168.1.10 test1.example.com 
192.168.1.11 test2.example.com 
192.168.1.12 test3.example.com 


的 hosts 文件 


1.110 test1.example.com 
1.111 test2.example.com 
1.112 test3.example.com 


B 
192,168. 
192.168, 
192.1686. 


5 客户 端 C 的 hosts 文件 


192.168.1.210 test1.example.com 
192.168.1.211 test2.example.com 
192.168.1.212 test3.example.com 











Ns J/ 

如 上 所 述 ， 使 用 Selenium 进行 的 是 集成 测试 ， 所 以 和 单元 测试 的 并 
行 执行 不 同 ， 浏 览 厅 端 的 机 和 着、 服务 天 闪 的 机 条 或 数据 库 服 务 仙 等， 其 
中 任意 一 项 的 高 负载 都 会 造成 测试 不 稳定 。 根 据 具 体 的 原因 处 理 方 法 也 
有 所 不 同 。 在 推进 测试 的 并 行 热 行 过 程 中 ， 机 天 的 负载 是 需要 注意 的 问 


题 之 一 O 
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7.5 ”多 个 应 用 程序 版 本 的 测试 





第 3 章 中 介绍 了 灵活 运用 版 本 管理 系统 是 顺利 进行 团队 开发 所 必 不 
可 少 的 要 素 。 当 然 不 仅 是 代码 ， 测 试用 例 也 应 该 进行 版 本 管理 。 这 样 就 
可 以 对 系统 的 多 个 版 本 进行 测试 ， 其 优点 有 如 下 这 些 。 





e@ 在 发 布 后 的 版 本 中 发 现 bug， 需 要 紧急 发 布 的 情况 下 ， 如 果 能 
实施 自动 化 测试 ， 就 能 够 安心 地 发 布 

e@ 能够 和 罕 急 发 布 的 测试 并 行进 行 下 一 次 发 布 的 开发 工作 

e@ 每 个 开发 团队 在 不 同 的 分 支 上 开发 的 情况 下 ， 可 以 在 该 分 支 上 执 
行 其 对 应 的 测试 用 例 ， 在 向 主 代 码 库 提交 之 前 实施 目 动 测试 


这 里 介绍 一 下 对 多 个 版 本 进行 Selenium 测试 的 方法 (图 7.25 )。 首 先 ， 
用 Jenkins 的 “Parameterized Trigger pluguin” 来 指定 对 哪个 版 本 执行 测试 。 
假设 这 里 设置 的 变量 名 字 为 APP VERSION， 那 么 在 Jenkins 的 任务 配置 中 ， 
用 名 为 ${RAPP_VERSION } 的 变量 就 能 在 构建 时 取得 指定 的 版 本 。 


图 7.25 对 多 个 版 本 进行 Selenium 测试 


应 用 程序 
( 服务 器 端 1.2 ) 
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7.5.1 应 用 的 部 署 


通常 ， 对 应 用 程序 的 多 个 版 本 进行 单元 测试 时 ， 只 需要 将 代码 变更 
为 特定 的 版 本 就 可 以 进行 测试 了 。 而 Selenium 测试 则 需要 从 部 署 应 用 程 
序 的 特定 版 本 开始 着 手 。 因 此 ， 测 试 的 整体 流程 可 分 为 “部 署 应 用 程 
序 ” 和 “用 Selenium 测试 "。 可 以 使 用 Jenkins 的 构建 流水 线 或 任务 关联 
等 来 构筑 这 样 的 流程 。 








7.5.2 ”从 版 本 管理 系统 下 载 测试 用 例 


接 看 从 版 本 管理 系统 上 下 载 测 试用 例 。 当 然 前 提 是 测试 用 例 和 代码 
一 样 都 进行 了 版 本 管理 。 

在 Jenkins 的 测试 任务 的 工作 目录 下 ， 以 各 版 本 为 目录 名 保存 测试 用 
例 (图 7.26) 使 用 Git 管 理 代码 的 情况 下 ， 可 以 将 Git 插件 的 “高 级 ”下 
的 “Local subdirectory for repo ( optional 》 设置 为 “TestSuite/s${APP 
VERSION}”。 如 果 忘 记 进 行 上 述 配 置 ， 各 版 本 的 测试 用 例 就 会 被 直接 下 
载 到 测试 任务 的 工作 目录 下 ， 和 其 他 版 本 的 测试 用 例 混 在 一 起 ， 因 此 需 
要 特别 注意 。 




















7.5.3 用 Selenium 测试 


seeeeeeeeeeeeeseseseseeeseeseseeseeseeseseeeseeeeseeeseeeeeeeseseseeseeseeeseeseeseseeeeeeseeseoeeeeeeeseeee 


正如 7.3 节 中 讲解 的 那样 ， 只 需 在 “seleniumhq Plugin” 的 suiteFile 
中 设置 刚才 下 载 的 测试 套件 ， 即 可 执行 测试 。 可 以 将 suiteFile 设置 为 
“S${WORKSPACE}/TestSuite/${APP VERSION ) /Login.nhtm1l ， 
这 样 就 可 以 对 多 个 版 本 进行 测试 了 。 
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图 7.26 ”保存 各 版 本 的 测试 用 例 


f 











TestSuite 


login.html 
login_successful.html 


login_failed.html 


login.html 
login_successful.html 
login_failed.html 
user.html 


create_user.html 
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7.6 ”本章 总 结 


如 本 章 所 述 ， 目 动 化 的 回归 测试 能 够 使 发 生 退 化 bug 的 风险 最 小 
化 ， 同 时 又 是 能 快速 、 持 续 地 进行 功能 添加 和 改善 的 有 效 手段 。 除 此 之 
外 ， 本 章 还 介绍 了 作为 其 工具 的 浏览 硕 驱 动 测试 工具 Selenium， 以 及 为 
了 高 将 地 实施 Selenium 测试 而 进行 的 Selenium 和 Jenkins 之 间 的 关联 。 

回归 测试 不 仅 是 开发 人 员 实 施 的 单元 测试 ， 还 包括 从 用 户 视 角 进 行 
的 集成 测试 、 用 户 验收 测试 。 在 持续 的 系统 版 本 更 新 时 ， 这 些 是 非常 强 
有 力 的 测试 手段 。 

但 是 要 补充 一 下 ， 回 归 测 试 的 自动 化 未 必 会 使 测试 代码 减少 。 使 用 
Selenium 的 测试 自动 化 有 时 会 需要 大 量 的 维护 工作 。 也 有 比较 适合 进行 
手动 测试 的 情况 。 因 此 在 制作 目 动 化 测试 时 ， 可 以 先 思 考 一 下 正 要 制作 
的 测试 今后 会 被 执行 几 次 ,今后 需要 怎样 的 维护 等 。 








图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


参考 文献 网址 





seeeeeeeeseeeeseeeseseseeseeseeeseeseeseeeseseeeeseesoeeseseeeseeseeseeseeseeseeseseeeeeeseeesseeseeseeeeseseeseeeeseeeeeeeeeoeeeseeseeeeeeee 


Andrew Hunt、David Thomas( 车 )， 马 维 达 ( 译 )， 程 序 员 修炼 之 道 : 从 小 工 到 专家 ， 
电子 工业 出 版 社 ，2011 


WEB DB PRESS 篇 集 部 三 集 ， 开 纯 之 一 几 徽 底 攻略 ， 技 术 评 其 社 ，2013 
营 野 裕 、 今 田 忠 博 、 近 了 蔷 正 裕 、 杉 本 琢 腾 ，Trac 入 门 ， 技 术 评 论 社 ，2013 
Michael C. Feathers ( 车 )， 候 伯 征 ( 译 )， 修 改 代 码 的 艺术 ， 机 械 工 业 出 版 社 ，2014 


Ken Schwaber、Jeff Sutherland (车), 王 军 ( 译 )，30 天 软件 开发 : 告别 瀑布 拥抱 敏 
捷 ， 人 民 邮 电 出 版 社 ，2014 

Brian W. Fitzpatrick 、Ben Collins-Sussman, Team Geek: A Software Developer's Guide 
to Programming Well with Others，ORellly Media, 2012 

Avram Joel Spolsky, Joel on Software, APress, 2004 


G.Pascal Zachary ( 著 )， 张 银 硅 ( 译 )， 观 止 -- 微软 创建 NT 和 未 来 的 夺 合 狂奔， 机械 
工业 出 版 社 ，2009 


人 Git、 版 本 管理 系统 
大 翅 弘 记 ，Git 案 践 入 门 一 一 Pull Request (上 双开 人 线 四 变革 ， 技 术 评 论 社 ，2014 


演 野 纯 ， 入 门 Git， 秀 和 水 又 二 和信，2009 











Travis Swicegood, Pragmatic Version Control Using Git, The Pragmatic Programmers, 
2009 


Pro Git ( http://git.oschina.net/progit/ ) 
猴子 都 能 懂 的 GIT 入 门 ( http://backlogtool.com/git-guide/cn/ ) 


The version timeline (http://codicesoftware.blogspot.com/2010/11/version-control-timeline. 
html ) 


Astonishments,ten,in the history of version control (http://www.flourish.org/blog/?p=397 ) 


分 散人 一 学 管理 到 间 VW 从 \\* 人 2 区、 从 了 上 一 (http://local.joelonsoftware.com/ 
wiki 分 散 作 一 沁 提 岂 管 理 亿 间 首 WW 六 Wo 区 、 信 了 世 一 ) 


A successful Git branching model (http://nvie.com/posts/a-successful-git-branching- 
model/ ) 


GitHub Flow (http://scottchacon.com/2011/08/31/github-flow.html ) 
人 Scrum、 敏 捷 开 发 
Mike Cohn ( 车 )， 宋 锐 ( 译 )， 敏 捷 佑 计 与 规划 ， 清 华 大 学 出 版 社 ，2007 


西村 直人 、 永 河 美 种、 吉 羽 龙 太 朗 ，SCRUM BOOTCAMP THE BOOK,， 翔 泳 社 ， 
2013 


图 灵 社 区 会 员 ling2656990(2656990@sina.com.cn) 专 享 尊重 版 权 


参考 文献 .网址 | 299 


平 锅 健 见 、 野 中 郁 次 妇 ， 了 沁 记 1 儿 开 低 又 夕 了 了 人， 翔 泳 社 ，2013 

长 河 嘉 秀 ( 监 修 )、 高 昌 勇 人 、 渡 边 座 、 株 式 会 社 元 夕 了 口 世 > 旋 了 一 下 (车 )， 了 当 
芝 款 几 开 线 闻 让 学 又 > 盖 下 力 个 > 力克 人  ， 技 术 评 论 和 社 ，2013 

前 川 直 也 、 西 河 诚 ， 殷 从 0 之 十 v>* 了 沁 字 人 儿 开 登 四 教科 书 ， SB 心思 工 咎 示人 了 ， 
2013 


EE build: 测试 

Janet Gregory、Lisa Crispin( 车 )， 孙 伟 峰 、 崔 康 〈 译 )， 敏 捷 软 件 测试 : 测试 人 员 与 
敏捷 团队 的 实践 指责， 清华 大 学 出 版 社 ，2010 

渡 边 修 司 ，JUnit 突 践 入 门 ， 技 术 评 论 社 ，20 

Srirangan, Apache Maven 3 Cookbook, Packt Publishing, 2011 

野 河 直 树 、 横 田 健 店 ，Apache Maven 2.0 入 门 Java: 才 一 了 YY 一 又 : ENFRY 一 儿 ， 
技术 评论 社 ，2006 

川口 耕 介 ， 详 解 Jenkins, WEB DB PRESS Vol.67， 技 术 评 论 社 ，2012 

Selenium-Web Browser Automation (http:/www.seleniumhq.org/ ) 

访 书 义 毛 | 案 践 刀 演 二 不 儿孙 又 让 」 http:/somat.hatenablog.comy/entry/20100919/ 
1284922305 ) 

Selenium 何 二 加 二 人 VWWD 一 几 太 安庆 证 色 祁 思 如 DD 注 上 9W9 和 这 太 DD 办 (http:1/ 
blog.trident-qa.com/2013/05/so-many-seleniums ) 

月 未 Seeniiiiai Se 二 全 Selenium IDE 办 疡 闷 一 又 出 力 才 吾 际 O 了 才 
一 也 > 下 0 变更 这 VE 一 一 (https://groups.google.comy/forum/#lItopic/seleniumjp/ 
1]PoYX-Qmu3k ) 


ee 持续 集成 

Paul M. Duvall 、Steve Matyas 、Andrew Glover ( 车 )， 王 海 鹏 〈 译 )， 持 续集 成 : 软件 
质量 改进 和 风险 降低 之 道 ， 电 子 工 业 出 版 社 ，2012 年 

John Ferguson Smart, Jenkins: The Definitive Guide，O Reilly Media, Inc, USA, 2011 


佐 汞 蛙 规 ( 著 、 轿 修 ) 和 田 贵 入、 河村 雅 人 、 米 深 弘 树 、 山 岸 入 ( 著 )，Jenkins 突 践 
人 门 ”~E 放 下 了 又 上 仆 天 7P7T 友 自动 化 才 吾 技术 ， 技 术 评论 社 ，2011 


ee 持续 交付 

David Farley、Jez Humble ( 著 )， 乔 梁 〈 译 )， 持 续 交 付 : 发 布 可 靠 软 件 的 系统 方法 ， 人 
民 邮 电 出 版 社 ，2011 

伊 膝 直 也 ，Chef Solo 一 一 Infrastrucuere as Code，2013 

新 原 雅 司 ， 入 门 力 下， 技术 评论 社 ，2013 


Open Source Provisioning Toolchain ( http://www.slideshare.net/dev2ops/velocity-online- 
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员工 : “老板 , 我 要 加 工资 ! ” 


老板 : “为 什么 ? ” 
员工 : “因为 我 长 得 帅 ! ” 
老板 . ee 小 


员工 : “因为 我 跟 你 10 年 了 , 没有 功劳 也 有 苦 劳 吧 1” 
老板 : 加 5% 差 不 多 了 。 

员工 : “这 个 项 目 交 给 我 , 我 有 办 法 只 需要 一 半 的 人 手 就 能 完成 ! ” 
老板 : “ 真 的 ? 好 ! 工资 翻 倍 ! ” 





人 重要 的 邮件 太 多 而 无 从 下 手 人 没有 能 用 于 验证 的 环境 
从 覆盖 了 其 他 组 员 修正 的 代码 人 无 法 自信 地 进行 代码 重 构 
人 不 知道 bug 的 修正 日 期 ， 也 不 能 追踪 退化 …… 


那么 ， 你 可 能 需要 这 本 书 | 

太 系统 讲解 团队 开发 所 必需 的 工具 和 方法 

太 详细 介绍 各 个 工具 的 特性 及 使 用 要 点 ， 并 进行 比较 
太 自动 化 意识 贯穿 全 书 ， 真 正 实现 高 效 开发 


LSBN 978=-7-115-29594-1 
Re iTuring.cn | | | 
es es (010)5 T09818645000 9 787115129594 人 > 
0 立 E 当 本 计算 机 /软件 工程 与 软件 方法 学 ISBN 978-7-115-29594-1 
人 民 邮 电 出 版 社 网 址 : www.ptpress.com.cn _ 定价 : 49.00 元 
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元 了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 
有 编辑 或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨 论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com。 
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